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THE USER GUIDE GUIDE 
Mike Lloyd is working on the QL User 
Guide Guide and we now hope to have 
the first instalment for March. We hope 
that it will be a centre-spread pull-out 
as well, so that you can store it 
separately. 


HARD DISK COMMENTS 
New hard disk owner Bryan Davies 
shares his experiences so far with the 
modern medium. 


TES CENE 


New from Van | German Group 
der Auweras 


Progs Van der Auwera have 
released a new program, 
Qractal, which (oddly enough) 
generates Mandelbrot or Julia 
set pictures on the QL. Qractal 
is described as featuring fast, 
precise 2” fixed point calcula- 
tions, toggling between a 
Mandelbrot set picture and its 
Julia equivalent; saving, re- 
drawing, recolouring of maps 
‘to discover the hidden struc- 
ture of the set’, 100% machine 
codeand multitasking program 
using pointer environmentand 
menu extensions; save option 
for created screens; inner set 
filling with attraction count of 
value; option to change co-or- 
dinates of Mandelbrot centre; 
supports BDM or bnary de- 
composing, mode4 and 


mode8, variable maximum 


Changes in Quanta 


number of iterations; easy 
zoom; special clear colouring 
method; option to make pa- 
rameter files. The program 
comes on three disks with 
sample charts, and costs £40 
sterling (including conversion 
costs) or Belgian francs 2000 
(post free in EC, post BEF 300 
outside EC area). 

The Van der Auweras have 
also updated The Painter to 
V4.00. The cost of the update is 
£14 (BEF 800) without binder, 
£17 (BEF 1000) with binder. 
Add £10 postage/bank con- 
version charge if sending a 
Sterling cheque (BEF cheques 
do not incur the extra charge). 

Progs Van der Auwera are 
at Haachtstraat 92, 3020 
Veltem, Belgium. Tel (local) 
(016) 488952. 


Editor resigns 


The Novemberissue of the user 
group Quanta magazine has 
someupdates on sub-group in- 
formation, and details and 
maps relating to the November 
workshop in Nottingham. 
Apart from that, the A5 maga- 
zine is mainly full of tips and 
responses from members. It's 
entertaining to see the familiar 
DIY Toolkit headline suddenly 
pop up at the back in a full- 
page list of Simon Goodwin's 
Toolkit disk collection, avail- 
able from CGH Services. 

The November editorial 
comments that The Consumer 
Protection Office in Birming- 


ham now has a number of 
complaints against supplier 
PDQL, along with an odd 
comment about the office’s 
“new address”. The address — 
the same one that appeared in 
QL World October 1990 — is 
given as 155-157 Corporation 
Street, Birmingham B4 6TH. 

We note that the Essex sub- 
group has been ‘re-chaired’ by 
Ron Dunnett. Ron is also try- 
ing to set up an ‘out of Quanta’ 
public domain library and 
would appreciate support. 

As we write, we hear that 
Sarah Johnson has resigned as 
Quanta editor. 
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The Sinclair QL User Group 
Ev (SQLUC) of Germany has 
nearly 1,000 members, mainly 
in Germany but also in Japan 
and other parts of Europe and 
has been in action for nearly 
Six years. 

SQLUC publishes a quar- 
terly magazine in German, 
Quasar, and holds local meet- 
ings monthly. “The QL is not 
at all dead, but remarkably 


Congratulations to the follow- 
ing winners in the MSM 
November subscriptions re- 
newal draw: 


J] A Pedder of Luton wins 
£150 

A J Smith of Northampton 
wins £50 

R D Knight of Essex wins 
£50 


When subscribers renew, 
their names will automatically 
be entered in the monthly re- 
newal draw. You can renew at 
any time. Call 091 510 2290. 
Good luck! 


alive. .. anyone who roughly 
understands German should 
think about getting a member- 
ship in our non-profit 
organisation”, says Foreign 
Contact Franz Herrman. 


The Sinclair QL User Club 
EV are contactable via Franz 
at Talstrasse 21, D-W5460 
Ochenfels, W. Germany. Tel. 
(local) (0) 2644-1855. 


lt'saQ 


Qlympic, publishers of Gob- 
lin’s Quest, have written to say 
that the instructions for the 
program can now be read on 
televisions as well as moni- 
tors, Olympic also have a new 
telephone number (German 
local) 02134 96694. 

We also apologise for print- 
ing Qlympic’s name as 
‘Olympic’ — we had a flag out 
tocatch that very obvious mis- 
take, but it got through. We 
hope it won‘t happen again. 

Qlympic’s address is 
Qlympic Computer Systems, 
Quellenweg 18, 4220 
Dinslaken, W. Germany. 


New Sub-group 


The first meeting of the new 
Quanta sub-group in London 
was held on August 1 at the 
Marquis of Clanrickad pub 
near Paddington Station. Tony 
Firshman of TF Services gave 
a demonstration of the QBox 
bulletin board, Mark Knight 
demonstrated his Molecular 
Graphics chemistry program 
(available from the Microdrive 
Exchange) and Laurence 
Reeves of QView gave a talk 
on Minerva. 


The subject of the Septem- 
ber meeting was QPAC2, the 
rewrite of Oram. 

There will bea hands-on op- 
portunity to try QPAC2., Each 
meeting will have a “begin- 
ners’ corner”. 

Subsequent meetings will 
take place on the first Wednes- 
day of each month. For 
information contact Jeremy 
Davis, 6 Elmcroft Crescent, 
Harrow, Middx HA2 6HN. 
Tel. 081 863 1631. 


Neen Gua 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


I’m a first-year computer 
science student at Brunel Uni- 
versity,and I haveseen appeals 
for QLnews through Electronic 
Mail. 

There must be a few more 
OL owners who are university 
based with access to a main- 
frame. If so | would welcome 
electronic mail from them at 
589559 @ UK, ac, brunel, cct. 

I’m ina sandwich course, so 
am going for industrial place- 
ment very soon but these 
computer-ese people are wel- 
come to write to me at home. 

Sunil Gupta 

45 Marlborough Crescent 
Grays 

Essex 


Ihave been going to write to 
you for some time to say that I 
think the QL World is a most 
excellent magazine. 

Itis perhaps invidious to pick 
out particular contributors but 
Mike Lloyd’s series on Better 
Basicand SuperBasic have been 
immensely educative and en- 
joyable. Also, Simon 
Goodwin's DIY Toolkit has 
provided many helpful titbits 
along the way. 

So glad to learn that the 
magazine has survived an 
upheavel that could have seen 
its demise. 


JW Hill 
Matlock 
Derbyshire 


NE 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair QL World, 
116/120 Goswell Road, London EC1V 7QD. 


I was interested toread Bryan 
Davies’ comments about the 
upgrade paths (un)available to 
QL users (October 1990). As a 
QL owner since 1985, I was 
very interested to read about 
some of the ideas being thrown 
around at the moment. 

Having already decided to 
buy another computer, I have 
been shopping around look- 
ing at IBM compatibles with 
the view to buying a ‘386 (SX) 


‘ system for myself. However, I 


have yet to come across a sys- 
tem that gives me the flexibility 
of true concurrent programs 
(Yes, some of us do use it!) 
together with a very good in- 
terpretation of Basic that I 
currently have access toon my 
QL. I find myself in the posi- 
tion that Iam not preapred to 
pay the sums of money re- 
quired to buy a machine that, 
in almost every respect except 
speed, is inferior to my QL. 

So, in answer to your 
solicitation for ideas for new 
machines, I have included my 
‘dream machine’ spec. 

In my sunny, happy (QL) 
world I would be able to buy a 
‘box’, with say a ten slot 
backplane (obviously built toa 
non-standard spec!) and the 
following cards installed. 

CPU Card: 68040 processor 
running at 25 MHz with an 
amount (expandable?) of cache 
memory. 2MB of SIMM 
memory onboard. QDOS+ 
multitasking operating system 
in ROM (basically a 32 bit 
amalgamation of QDOS, TK2, 
TK3 and DIY toolkit routines) 
including a “TaskMaster’ sort 
of program/ multitasking / file 
manager shell. Keyboard 
driver chips. 

Memory Card: An address 
selectable memory card 
expandable to 4MB per board 


using standard SIMM’s. Each 
system would be able to ad- 
dress a maximum of 7 such 
cards to give the possibility of 
28MB of ‘flat’ expansion 
memory. 

Dise Interface Card: Inter- 
face allowing connection of 2 
Floppy drivers and a hard 
drive. Formatting, copying and 
backup routines contained on 
‘local’ rom to allow true back- 
ground task disc operations. 

Video Board: Resolution 
around double that of the 
present OL display, and with 
an expansion of the palette. 

Application Board: An 
EPROM/ROM allowing the 
installation of up to 16 applica- 
tion EPROMS which could 
then provide for embedded 
application multitasking. 
Workstations could be pro- 
duced just using a floppy for 
data storage, all applications 
being on board and running at 
boot-up time. 

Other boards could include, 
modems, real-world interface 
and development boards etc, 
etc. The use of a standard (sic) 
bus and the availability of 
blank boards could start many 
people experimenting furi- 
ously, not least of all myself. I 
have deliberately refrained 
from including a price range 
for this ‘dream machine’ be- 
cause we all know that dreams 
do not come cheap. This, 
however, would be one dream 
that I would sell (almost) eve- 
rything for! 

As for all the redundant 
QL’s, I'm getting interested in 
simple multiprocessor appli- 
cations so I'll take them off 
everybody for a fair price, al- 
though I’m sure many other 
can think of things to occupy a 
QL put out to graze! Any tak- 
ers for my dream? 

Gareth Williams 
Shepperton 
Middx 
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REVIEW 


he QL has always lacked 

; ameans of retaining the 
correct time and date 
when it is switched off. In the 
past, there have been one or 
two systems which have 
managed to overcome this 
short-fall; but with the pas- 
sage of time, these have 
become more and more diffi- 
cult to obtain. This is a 
relatively recentsystem, which 
comprises a small circuit 
board, a small rechargeable 
battery and a few more Basic 
commands to load from disk. 
The hardware element is 
quite simple to install. You 
open your QL (by removing 
eightscrews), and remove two 
chips: the 8301 (whichis a large 
chip next to the 68008) and one 
of the tworom chips. Next you 
push the main circuit board 
firmly into the empty rom 
socket, and push a through 
connector into the 8301 socket. 
Now all you have to do is re- 
place the two chips by placing 
the rom and the 8301 chip into 
the supplied circuit board and 


tively, decide where to place 
the battery (there is room next 
to the expansion socket), and 
screw the QL back together. 


File 


Users who already have 
something else in one of the 
rom sockets, such as Minerva, 
or the Qimi interface, should 
not experience any problems, 
since the real time clock will 
quite happily sit in either rom 
socket. I did however find that 
the board supplied and the 
Minerva circuit board formed 
avery tight fit. Although I was 
| able to install the board with- 
out too much trouble, some 
users may find that they need 
to file a little bit off one of the 
boards. 

The instructions for fitting 
the Clock board are very 
straightforward and should 
not cause any problems. One 
thing however that the manual 
omitted to mention was that if 


through connector respec-- 


The QL has always 
been short of a 

perpetual time and 
date function. Rich 


Mellor tries a 


battery-backed 
board which uses 
one of the rom 


sockets. 


you are unsure which way 
around the chips faced, there 
isasmall notch on them which 
should always be towards the 
rear of the QL. 

Once installed, the QL clock 
can be set to the same date and 
time as that kept by the real- 
time clock by using one of the 
four supplied Basic keywords. 
Should the stored date and 
time ever be incorrect (for ex- 
ample if the battery is running 
low) then you can set the QL 
clock manually and then use 
another new keyword to write 
‘this value to the battery- 
backed clock. Using this 
method means that the time 
on boot-up cannot be cor- 
rupted accidentally by 
software which uses SDATE 
for its own purposes, nor 
should it be corrupted by the 
QL being switched on and off. 


Recharge 


One advantage of this pack- 
age is that there is never any 
need to replace the battery, 
since it constantly recharges 
itself whenever the OL is 
switched on. It should be able 
to keep the time and date ac- 
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wow REALTIME 


curately for up to one month 
without the QL ever being 
switched on, which should be 
more than ample for most QL 
users. 


Extra 


A small oddity with the 
package is that there is a spare 
32 bytes of ramon board which 
is also preserved by the bat- 
tery. This is accessed by using 
the other two new Basic key- 
words, but is so little as to 
prove not very useful, how- 
ever the manual suggests that 
it could be used to store de- 
fault baud rates or a default 
directory for Toolkit II. A more 
useful idea would be to use it 
to store a password for a soft- 
ware package; unless the 
unwelcome user knew that this 
memory existed, he would 
find it very hard to trace the 
password. 

On the minus side, certain 
things plugged into the OL 
rom port can affect the real- 
time clock, since it is located in 
the last four addresses used 
by the rom port. This should 
not give many problems (cer- 
tainly Toolkit II, Ice and 
Lightning all work okay), and 


REVIEW 


can easily be checked before 
ordering the package by the 
following lines: 


10 FOR a=1 TO 4 
20 PRINT PEEK (1024*64-a) 
30 END FOR a 


If the values returned are all 
either 0 or 255, then you will 
have no problems. In the 
manual Phil states that he may | 
be able to adapt the package 
for use with problem roms, 
but this will only be effective 
on JM and Minerva OLs. 

Overall the package is ex- 
tremely useful and 
considering the cost of mak- 
ing a hardwareadd-oninsmall 
quantities, is quite cheap. 
When balanced by the time 
and effort required to set the 
QL clock each time the QL is 
reset, the package is a bargain. 


A P 


he new WP program Perfection 
was advertised in the December 
issue. Those readers who have 
good spectacles will have noted 
in Digital Precision’s advert that the pro- 
gram is full of features —far too many to be 
commented upon adequately here. Hav- 
ing been using a ‘beta test’ version of the 
program, |can confirm thatitis good. It will 
take time to get familiar with the many 
functions, but users who just want a faster 
Quillshould not be deterred by this, as the 
program can be used without a lengthy 
study session being needed before firing 
it up. To try and satisfy what one might 
categorise as QL World and Quanta us- 
ers, the user interface comes in two forms: 
one with menus similar to those in Quill, 
and the other having combination keying 
more akin to what an editor has. As many 
users get along quite happily without hav- 
ing their spelling checked, the 
spell-checker is an optional extra. 


Perfection 


Although Perfection is in the same mar- 
ket area as text*’, it has a different feel to 
it and the two programs are actually 
somewhat complementary. Perfection 
does not set out to make the screen look 
like the printed page, but it has a more 
obvious bias towards the programmer than 
tex®’ has, in that many more commands 
are built-in for tailoring the behaviour of 
the program to the user's requirements. 
For example, the ‘lazy screen’ feature can 
be switched on or off. This means that text 
can be scrolled line-by-line, with all lines 
being shown at all times in their correct 
relative positions, or the whole display 
except the top or bottom line can be held 
static while just the one line changes (very 
rapidly). Not surprisingly, users of The 
Editor will find much to commend in the 
new program. Speed has been a target 
throughout the development of the pro- 
gram, and that aim has largely been 
achieved, with almost every function be- 
ing performed briskly. As lack of speed is 
a major drawback of Quill, Perfection 
should prove a worthy successor. Having 
been assured that the version | am using 
is about to be replaced by a much faster 
one, | look forward to the latter being quite 
something. 

Adding the new program to the system 
disk reminded me how long it has been 
since | had to make any significant change 
to the system. It's nice not to have to keep 
chopping and changing, but a change 


Bryan takes afirstlook 
at DP's new word 
processor 


every now and then is healthy; it prompts 
you to think afresh and, maybe, do other 
jobs which had been forgotten. Despite 
the wonders of both Perfection and tex#*”’, 
| still feel happier going back to The Editor 
when making changes to SuperBasic pro- 
grams. You never quite seem to find one 
program that does everything for you, but 
give the new program consideration for 
text, database and SB programming use. 
Its high basic speed fits it for all three 
requirements. 

Di-Ren, the producers of Fleet Tactical 
Command, are emphasising their hard- 
ware activities these days, and have 
introduced a small, cheap box for check- 
ing the health of QL networks. Called the 
‘network prover’, this device sells for £3.50 
(plus post and packing, and VAT). It is 
plugged in-line with the network lead be- 
tween two QLs. A led on the box flashes 
when transmission is taking place over 
the network; when one QL is expecting 
data from another, but is not receiving it, 
the led comes on continuously. It was no 
surprise to find the network between my 
two QLs in a good mood when | came to 
test the device, but it was easy enough to 
simulate a fault condition by pulling one 
end of the network lead out, whereupon 
the led duly came on continuously. 

Don't expect the led to flash all the time 
when the network is in use; if drives are 
running, data transmission is held up and 
the led won't flash, so there are only brief 
periods of flashing in-between long peri- 
ods off, if you make copies between 
microdrives. The led does not come on 
continuously to indicate faults which are 
not the responsibility of the network; for 
example, pulling out a cartridge part-way 
through a copy operation is not a network 
fault, although it certainly halts any net- 
work operation that was in progress. 

The cartridge used for checking the 
network prover was picked at random 
from a box-full of cartridges, none of which 
get any significant amount of use. The 
WCOPY command was used to copy files 
from flp1 on one system to mdvi on the 
other. After much running of the cartridge, 
itbecame clear that something was amiss. 
It was not a network fault, so the led didn’t 
come on. Being occupied with other things, 
| didn't check the QL for some minutes 
and, when | did, the fault turned out to be 


a defective cartridge. The tape was 
jammed, and my usual treatment — 
bouncing the cartridge off the workbench 
a few times — didn't relieve the situation. 
Every time | have to go back to using 
cartridges, | get trouble. Do other disk 
users find this? How did we ever get any 
work done in the ‘good old days’? 

As I've mentioned before, my personal 
experience of hard disk drives (on aPC, | 
hasten to add — not on the QL), leads me 
to feel floppies are a more reliable me- 
dium than either cartridges or hard disks 
(hear jolly well hear — Editor), Neverthe- 
less, there’s no way | would go back to 
using floppies as my main storage device, 
after a few years using hard disks, any 
more than a floppy user would go back to 
microdrive cartridges. 


Expands 


Computer equipment gradually expands 
to fill your available workspace, and one 
of the things you may need at some point 
is a switch for your printer(s). Maybe you 
have two computers using the same 
printer, or one computer using two print- 
ers; the problems is the same, but the 
necessary hardware may be slightly dif- 
ferent. Before posting your mail-order 
cheque off, do a bit of ‘thinking on paper’. 
Printer switches tend to be expensive, but 
you can get them for a reasonable figure. 
A 2-way, 36-line manual switch need cost 
no more than about £15; paying two or 
three times that much will very likely get 
you the identical switch to the cheaper 
one. (I know, since I’ve recently spent 
about £30 on one, because the supplier 
advertising the same switch at £15 had no 
stock, and | was in a hurry.) A 2-way 
switch will have three connectors on the 
rear, and the connector types vary with 
the purpose the switch is to be put to. 
Check the cables you already have, be- 
tween computer(s) and printer(s). Do they 
have 9- or 25-pin “D" connectors at the 
computer end, and the larger, 36-pin type 
at the printer end? A printer with a parallel 
interface will normally have the 36-pin 
type, male connector; they are easily rec- 
ognisable, usually being blue in the area 
of the connections, and the connections 
themselves being strips of metal rather 
than pins. Some printers have both serial 
and parallel interfaces, so you may find a 
25-pin connector also. In general, it is 
simpler to use the parallel interface, be- 
cause you as a user do not have to do any 
setting-up for it; you simply connect the 


Sinclair/QL World February 1991 


cable, whereas you may have to do some 
configuring (setting hand-shaking, parity 
etc) when a serial interface is used. 

The computer is most likely to have the 
25-pin D type, unless it happens to be a 
QL, in which case it has the BT-like PCC 
connector, or a 9-pin D (if itis aGerman or 
US machine). Most users will have a se- 
rial-parallel interface as a separate device 
for their QLs, the Miracle interface being 
the common one. This being the case, 
you don’t need to worry about the non- 
standard connector on the QL, when 
connecting the QL to a switch; the con- 
nector of concern is at the other end of the 
interface, and is the 36-pin printer type. 
Likewise if you have another computer, of 
a different type. Whatever the connector 
for its printer port, you should have acable 
for it which has a 36-pin connector at the 
printer end. If you have two computers, 
then, of whatever type, the chances are 
thatthe connectors on their printer cables, 
which will have to fit to a 2-way switch, will 
both be of the 36-pin parallel printer type. 
The remaining connector on the switch is 
the one which will be used for the printer. 
\fthat connector is the 36-pin type, you are 
going to need a 36-to-36-pin cable be- 
tween it and the printer, and that is not 
what suppliers will generally understand if 
you ask for ‘a printer cable’. Specify just 
what connectors you want on each end of 
any cable ordered — both the number of 
pins and the connector type, and whether 
they are male or female orientation. If you 
already have the necessary cables, sup- 
ply the same information when ordering 
the 2-way switch. 

When you have printer problems of the 
missing-characters variety, always blame 
the printer connections in the firstinstance, 
With so many points of contact - espe- 
cially when a switch is used — the chance 
of a bad connection is quite high. Sepa- 
rate all connectors, spray the pins with 
contact spray (definitely not any type of 
lubricating oil), and reconnect, making 
use of any locking devices on the connec- 
tors (try elastic bands to hold them 
together, if necessary). If the rotary con- 
nection wafers on aswitch are accessible, 
spray the tracks on them, too. 

The information which has been quoted 
in another magazine, that the President of 
Microsoft (who produce MS-DOS) is the 
33rd-richest man in the world. So far as | 
am aware, the source of his wealth is the 
one company, and basically that one pro- 
gram (although the WP program Word, the 
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multi-tasking program Windows, anda few 
other programs also sell well). Sales of 
MS-DOS have been quoted at about 11 
million copies per year, which is nice 
money at maybe £30 average per copy 
(most are sold to dealers). Incidentally, 
Digital Research, the producers of CP/M, 
sell a ‘compatible’ replacement for MS- 
DOS, called DR-DOS. This is claimed to 
do all the things the original fails to do, 
such as giving access to hard disks larger 
than 32 MB, making 50 KB or so more 
space available for programs, and sup- 
porting expanded memory, MS-DOS 4.01 
does provide some of these facilities now. 
PC Conqueror users might think about 
DR-DOS, if they haven't already got either 
MS-DOS or PC-DOS. 


Readers’ Letters 


As recorded previously, my recent mail 
has not included complaints about the 
Minervaroms, but obviously some suppli- 
ers have been getting regular complaints. 
The target of the complaints is sometimes 
the supplier of Minerva (QView) and 
sometimes the supplier of software which 
has problems when run with Minerva. 
Most users will not be in a position to know 
whether software or hardware is causing 
the problem, although that does not seem 
to stop some of the taking a strong critical 
stand, one way or the other. One of the 
aims of the developers of the roms has 
been to remove known bugs in Qdos, the 
QL operating system. A laudable aim, but 
perhaps coming rather late in the day, 
since software writers have for many years 
either found ways around the major bugs 
or added their own fixes into their pro- 
grams (or extensions files supplied with 
them). 

Fixing known (and agreed) bugs in Qdos 
is one thing, but accusing software writers 
of having bugs in their programs is an- 
other, and one which undoubtedly raises 
the temperature quite a bit. This looks a bit 
like the situation with certain programs, 
where the proponents of Minerva are stat- 
ing that they expect to see changes made 
to programs which have been sold for 
several years, and which have worked 
satisfactorily until the advent of (some 
versions of) Minerva. Some changes have 
been made, where it has been accepted 
that they were either necessary (regard- 
less of Minerva), or could be implemented 
quickly and easily, to keep Minerva users 
happy. The program writers are not mak- 
ing other changes because they do not 


accept that the problems are caused by 
their code; that is, they feel the fault lies in 
Minerva. A little more consultation before 
some of the rom development took place 
might have prevented all the users’ prob- 
lems. 

Here are some notes on reported prob- 
lems. Some versions of Minerva don't get 
along with some of the toolkit functions 
with the Turbo or QLiberator compilers, in 
some QLs. Some versions of Minerva and 
Professional Publisherdon’t work too well 
together; specifically, the ‘Edit Page’ close- 
up window can be blank, and 
high-definition founts may be unusable. 
Version 1.81 Minerva prevents 
Microbridge loading fully; this may be 
solved by increasing the Dataspace allo- 
cated to Microbridge by 1 KB (if you have 
the Turbo dataspace routine available). 
Unspecified programs will not work un- 
less the Minerva integer tokenisation 
function is switched off. FlashBack SE 
displays minorquirks when usedwith Minerva 
V1.81; Touch Typist does not load fully with 
the same version. The SEXEC command 
gives loading problems with some programs, 
when V1.82 Minerva is used. 

Spencer Harvey reports a lack of re- 
sponse (as of mid-November) from Sector 
Software concerning a printer interface, 
returned by him as faulty in June 1990. It 
has been suggested that the interface 
never got back to Sector, but letters con- 
cerning it did, and it would seem 
reasonable to have had some reply to 
them by now. A QL user who seems to 
have regular problems with his equipment 
(hardware and software) is J Roy Goodall, 
and his location (Belize) makes sorting- 
out problems a rather difficult and 
protracted business. He eventually re- 
ceived a long-delayed printer interface 
from Miracle Systems, along with a 
cheque which was apparently a refund of 
the cost for it, and has also purchased a 
Trump Card. He tried out TechniQL ona 
QL he has recently obtained, but had ‘the 
usual negative results’. Another acquisi- 
tion is a PS/2-style keyboard, from 
Keyboard Products: neither of his QLs 
will give the F1/F2 start-up screen with 
this keyboard fitted, so he is now awaiting 
comment on this problem. He says his 
rechargeable batteries for the Frequency 
Precision power back-up unit are in need 
of replacement, but this device has seen 
him through “many blackouts, and also 
overcame overheating problems", over a 
period of two years. 
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his is a user’s-eye re- 
port from the Second 
Italian QL Users Meet- 


ing which was held at the 
Management Conference 
Centre at San Felice del 
Bennaco which is on the 
southern shores of Lake Garda, 
halfway between Milan and 
Venice. 

The southern shores of Lake 
Garda are a beautiful part of 
the world to spend your time 
if you have any but there was 
no time for sightseeing at the 
Meeting. 


Committee 


The Meeting was as far as 
the Brits were concerned ably 
organised by Eros Ferrenzi, 
who is a student. The Users 
committee consisted of in- 
dustrialists and enthusiasts 
from northern Italy and the 
company called SPEM, owned 
by Guido Masoero, who op- 
erates from Turin and who 


ITALY 


THE 


ITALIAN 


JOB 


Users Meeting 1990 took place recently by Lake Garda. 


P: QL is still active in Italy, where the annual QL 


The verdict: a success, but rather hard to get there. 


the principal QL trader in 
Italy. 

Miracle Systems, who usu- 
ally travel to OL meetings by 
bicycle, left their bicycles be- 
hind and travelled by car to 
Dover and then to Brescia by 
train from Calais. Bill 
Richardson of EEC Ltd chose 
to fly carry ing several kilos of 
OL ‘product in his baggage, 
but despite Al Italia hospital- 
ity onboard found himself 
incarcerated in the Customs 
sheds at Milan Airport for 
three hours, missing the open- 
ing stages of the afternoon, 
when not many people at- 
tended. Another trade 
attendee was Jochen Merz 
from Germany, showing an 
updated Version 3 QD Editor 
and an improved range of 
software. 

Sunday was a beautiful 
morning and it would have 
been nice to have gone sight- 
seeing rather than the Show 
butonarrival we found twenty 
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to thirty OL enthusiasts wait- 
ing for us, mostly from local 
areas butseveral had travelled 
from as far as Rome and San 
Remo on the French/Italian 
border. 


Audiovisual 


During the course of the day 
several QOL presentations were 
held inanexcellent lecture hall 
well equipped with audio 
visual paraphenalia and ma- 
terial put over by the Italian 
delegates, Miracle Systems’ 
Stuart Honeyball and Jochen 
Merz. All was efficiently 
translated into Italian by the 
members of the User Group. 
The opinion of the UK exhibi- 
tors, Stuart Honeyball of 
Miracle Systems and Bill 
Richardson of EEC Ltd was 
that, while sales were good 
and most of the stock taken by 
both companies was sold, sales 
takings were great in millions 
of Lire but: condensed into 


pounds sterling it probably 
represented the kind of sales 
that one would have expected 
from a one day Show at the 
Horticultural Hall in London. 
Expenses were well exceeded, 
though, and it was felt that a 
number of orders will follow 
the visit. Quanta leaflets and 
back numbers on the EEC 
stand attracted a lot of atten- 
tion and a number of new 
members will result. 

Only about 100 visitors at- 
tended however and all 
exhibitors felt that the same 
faces seem to be around who 
we had previously met and it 
was thought that, bearing in 
mind the somewhat remote 
tourist area around Lake 
Garda, it would be nice to see 
other shows in the more 
populous areas of Italy such 
as for example, Turin or Rome 
and it was suggested by an 
attendee that a good place for 
a QL meeting be Florence in 
future. 
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OF 


yet many computer users cannot 

create them or modify them. Some 
are remarkably simple, while others are 
unavoidably complex. Most of them are 
essential, but on occasion they are merely 
convenient. Some have a single purpose, 
others offer a wide choice of options. 
Some never change, but many need to be 
modified to suit particular needs. They 
are, of course, boot files: short programs 
required to load and execute other pieces 
of software. 

Most of the requests | receive for help 
relate to boot files, particularly ill-consid- 
ered amendments to them which need to 
be put right. A quick straw poll amonst 
software sellers and producers reveals 
that boot files come pretty high up their list 
of reaons for customer calls. It is not that 
the boot files supplied with the software 
cause problems; it is the enthusiastic but 
badly-planned adjustments to standard 
boot files which lead to problems. 


a very computer system needs them, 


Bootfile 


This SuperBasic article and its succes- 
sor are devoted to the techniques and 
principles of the humble boot file, includ- 
ing a complete review of the commands 
involved, a look at boot file editing meth- 
ods, some hints and tips, and a simple but 
fully-functioning menu-driven boot file 
which can be adapted to suit your own 
software library. | hope it answers the vast 
majority of questions about the subject 
and reduces the number of calls for help to 
suppliers. 

To simplify the text and to avoid saying 
everything twice, | have assumed that 
floppy disks are being used throughout 
the rest of the article. If you are still using 
microdrives, replace all occurrences of 
FLP1_ with MDV1_ and translate all men- 
tions of ‘floppy disk’ and ‘disk drives’ to 
‘microdrive cartridge’ and ‘microdrive’. 

A boot file contains a number of pro- 
gram commands which are carried out 


when a disk or microdrivé is accessed 
during the boot-up sequence when the 
computer is first started. This is incredibly 
useful because, instead of being faced by 
a blank screen and a flashing cursor, 
users can be presented with their favourite 
program loaded and running automati- 
cally. 


Disk User 


The main purpose of a boot file is to 
issue the commands needed to load and 
execute another, larger program. It might 
also contain some commands to change 
aspects of the QL’s settings to meet the 
needs of the software it will launch. Disk 
drive users, who can place many substan- 
tial programs on a single disk, often 
develop a boot file with a menu so that 
they can select which software they wish 
torun. This isless likely to be the case with 
microdrive users because it is often not 
possible to place more than one large 
program on a single microdrive. 

There is nothing magic about a boot 
file's contents. Usually, they contain the 
commands which would otherwise need 
to be typed in by the user directly when- 
ever apiece of software was to be loaded. 
Generally, the commands in a boot file fall 
into three categories: file-loading com- 
mands, environment-setting commands 
and incidental commands. The file load- 
ing commands perform the job of loading 
programs from disk or microdrive and 
starting them off. Environment-setting 
commands might modify the screen set- 
tings, or establish parameters for the 
printer channel, so that the main program 
knows exactly how the QL will behave. 
Some users add extra commands to set 
up ram-disks, or make multi-tasking soft- 
ware available, in order to meet their own 
particular needs. Incidental commands 
include special screen displays, or per- 
haps a menu. 

Likewise, there is nothing very special 
about the file itself. It is simply a Qdos 


SUPER 


BASIC 


Most computer users occasionally 
write code to start software. Mike 
Lloyd provides a step-by-step guide. 


convention that when a microdrive is 
present in mdv1_, or a floppy disk is in 
flp1_, during the start-up sequence the 
operating system looks for a file called 
‘boot’. If it does not exist, nothing hap- 
pens, but if it does itis assumed to contain 
SuperBasic commands which are ex- 
ecuted. If you forget to put a microdrive or 
disk in place when starting up the compu- 
ter, type LRUN FLP1 BOOT in the 
command window and press Return. 
LRUN is a SuperBasic command which 
means “Load and RUN” and can be used 
to launch any SuperBasic program. 

Incidentally, boot files are not particular 
to the QL: all modern operating systems 
have them. In MS-DOS, they are called 
AUTOEXEC. BAT files and in Unix they 
are called .PROFILE files, but their pur- 
pose is the same as the QDOS BOOT file. 
Of the three, the Qdos name is by far the 
most meaningful. 

Boot files are always standard 
SuperBasic program files, rather than be- 
ing machine code files. This ensures that 
they are easily readable and adjustable. 
To load a boot file without executing the 
commands it contains, start up the QL 
without a disk or microdrive in place. The 
QL screen will be set to the default accord- 
ing to whether the start-up sequence was 
initiated by an F1 or F2 keypress. The 
screen will contain three windows, al- 
though in the tv display mode only two are 
immediately apparent. The lower window 
is the command window, where 
SuperBasic commands are typed and 
program lines are modified. Above the 
command window are the listing window 
and the default window. In Monitor mode 
these windows are side by side whereas 
in TV mode the default window is super- 
imposed over the listing window. 

Toview a bootfile, place the appropriate 
disk in the flp1_ drive and type: 


COPY FLP1_ BOOT TO SCR_ 


The boot file will then be displayed in the 
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centre of the screen. Press the F5 key io 
| pause scrolling if the beginning of a long 
file looks in danger of scrolling off the 
screen. If each line begins with a number 
then the file can be loaded directly into 
memory. If there are no leading line num- 
bers we must add some before we are 
able to edit the boot file. 

To load a numbered boot file, place its 
disk in the appropriate drive and type in 
the command to load it into the QL’s 
memory: 


LOAD FLP1_ BOOT 


The disk drive will spin into life and if a 
file called BOOT exists it will be loaded 
and the cursor will flash ready for the next 
command. To view the file’s contents, 


type: 
LIST 


Sometimes, software developers write 
boot files which do not have line numbers, 
for reasons best known to themselves. If 
you wish to edit such a file, you can copy 
the details of the file from the screen (ora 
printout) and type them in again with line 
numbers, or you can use the short routine 
at Listing one to do the job automatically. 
The file it creates is called “NEWBOOT". 
When this file has been edited, delete the 
old BOOT file and save the amended 
version as “BOOT". 

Before we can begin to modify these 
commands their purpose must be under- 
stood. The heart of any boot file comprises 
the instructions to run the main program 
or programs, so let us look at those first. 


WARNING: Always edit acopy of the 
original boot file, not the original itself. 
That way, if you make a mistake it can 
be rectified by taking a new copy of the 
original boot file and starting again. 


There are three ways of causing a pro- 
gram to be run from file on the QL: the 
LRUN command for SuperBasic pro- 
grams, the RESPR/LBYTES/CALL 
sequence of commands for machine code 
programs and the EXEC family of com- 
mands for multi-tasking programs. 
Variations of these commands are avail- 


able in toolkits, and will be covered at the 
appropriate points below. 

Itis unusual for SuperBasic programs to 
be launched from boot files, but it can be 
convenient to do so and therefore the 
method is detailed here. The command is 
LRUN followed by the file name. Note that 
there is no point in following the LRUN 
command by any other commands as 
they will never be carried out: the incom- 
ing SuperBasic program completely 
overwrites the commands loaded from 
the boot file. 

Very little software for the QL has been 
produced in conventional machine-code 
format because it is easier and more ad- 
vantageous to make such programs 
multi-tasking. However, itis very common 
to see machine-code format programs 
which set up a multi-tasking program of 
some sort. Perhaps the prime example is 
Qram, the Multi-tasking utilities package. 
It is machine code programs such as 
these which lead to the majority of prob- 
lems encountered by QL World readers. 


Three Stages 


With standard Qdos and SuperBasic, 
loading a machine code program is a 
three-stage process. An area of the QL's 
random access memory (ram) must be 
specially designated for the program, the 
code must be copied from the disk into the 
designated memory area and, finally, the 
code must be started off. 

Memory is designated using the RESPR 
(REServed PRogram space} function. You 
ask the computer to reserve a memory 
area of so many bytes and the computer 
in turn tells you where that memory areas 
starts. The syntax for the command is: 


LET base = RESPR (2048) 


Here, the request is for a 2K chunk of 
memory and the first byte in that chunk is 
at the address number which Qdos will 
have placed in the “base” variable. You 
could just have easily typed: 


PRINT RESPR (2048) 


which would have reserved a space and 
printed its first address on the screen. 


LISTING 1 


Se ce ee a eee ee ae eT, 


q 


the italic remarks. 


Note; this listing is a stand-alone program which should be 
saved (eg SAVE fip!_editboot) before being runt. 


Do not type 


100 OPEN _IN#3, FLP1_BOOT 

110 OPEN_NEW#4, FLPL NEWBOOT 
120 LET NUMBER = [0 

130 REPeat LOOP 

140 IF FOF (#3); EXIT LOOP 
150 INPUT#3, A$ 

160 IF A$(1) <= "9" 
170 PRINT#4, NUMBER & " " 
i180 NUMBER = NUMBER + 10 
190 END REPeat LOOP 

200 CLOSE#3 

210 CLOSE#4 


| 220 PRINT "COMPLETED" 


: EX1T LOOP 
& A$ 


| Open existing boot file 
Open 4 new file 


Set fine number value 
LOUP:- 

Stop if file end reached 
Read next line from BOOT 
Stap if its already numbered 
Add numbered Jine ta NEWBOOT 
fnerement the line oumber 
END LOOP 
Ciose the BOOT file 
Close the NEWBOOT file 


Signal end of pregram 


Sinclair/QL World February 1991 


SUPERBASIC 


Putting the address into a variable saves 
the effort of writing it down and typing it 
directly into subsequent commands. 

You can find out how much space to 
reserve for a particular program by refer- 
ring to the product's manual or by using 
the WSTAT Super Toolkit command. 
Memory blocks are allocated in lumps of 
512 bytes, so there is no requirement to 
reserve exactly the right amount of space, 
provided that there is enough roped-off 
memory available. If you intend to load 
two or more machine code programs 
sequentially, you can reserve a single 
space to contain them all, provided that 
each is loaded beginning at an address 
which ensures that none are overwritten. 

RESPR will fail if there is insufficient ram 
available, or if there is a multi-tasking 
program running when it is called. The 
first restriction can be solved by removing 
any other reserved memory blocks which 
might be present, or by buying extra 
memory for your QL. The second restric- 
tion has been overcome by replacing the 
RESPR command with toolkit functions 
such as ALLOCATION, from the Turbo 
toolkit. 

Having reserved space in memory, the 
machine code program must be loaded 
into it. The command for this is LBYTES, 
followed by the file name and the address 
of the first byte of reserved memory space. 
To follow on from the RESPR command 
above, a typical command might be: 


LBYTES flp1_ little_ prog, base 


If a single ram area has been reserved 
foranumber of machine code files, care- 
ful control must be maintained of the 
starting 


Sharing 


address for each LBYTES command if 
problems of over-writing are to be avoided. 
Additionally, itis a Qdos rule that machine 
code programs must begin at an even- 
numbered address in memory. Let us 
take as an example the following Qram 
files, with their approximate sizes: 


flp1_ wman (5006 bytes) 
flp1_ ptr imi (9654 bytes) 
flp1_ ramprt (1024 bytes) 


Memory space can be reserved and 
occupied by the following commands: 


LET progA = RESPR (15684) 
LBYTES flp1_ wman, progA 


LET progB = prog A + 5006 
LBYTES flp1_ ptr_ imi, progB 


LET progC = progB + 9654 
LBYTES flp1_ ramprt 


The final part of the sequence is a CALL 
command which activates the code loaded 


19 


SUPERBASIC 


by the previous commands. The CALL 
command needs one parameter, the ad- 
dress of the first byte of executable code. 
Strangely, this might not always be the 
very first byte of the reserved area, in which 
case the software manual will advise you to 
use a command such as: 


CALL base + 12 


Fortunately, for everyone who finds this 
three-command sequence a bit of a bind, 
Tony Tebby’s Super Toolkit 2 contains a 
single command which performs all three 
tasks and which does not require the user 
to worry about start addresses, even-num- 
bered bytes and 512-byte memory chunks. 
| The command is LRESPR, and it is fol- 
lowed by a single parameter — the 
program’s file name. Therefore, instead of 


typing: 


LET base = RESPR (1024) 
LBYTES flp1_ program, base 
CALL base 


the following single command can be used 
instead: 


LRESPR flp1_ program 


The final category of runnable files com- 
prises those that can be multi-tasked 
together. To take full advantage of multi- 
tasking software it is best to purchase 


——DI REN 


Fleet Tactical Command Il 
Di-Ren’s Software Flagship 


Version 1 was unique and brilliant. 
Version 2 is in a class of its own!! 


Version 2 of this unique, Real Time, Fully interactive, 3- 
D Naval Wartime scenario simulator, that canbe esa 
via two computers connected via Network or Modem 
links, has many new features. 

‘Weather conditions’ for instance can range from ‘calm’ 
toa Force 11 Violent Storm! The Crew suffer fatalities 
and you can now 'Tow’' ships, A mostsignificant advance 
is the ‘TWO PLAYERS ON ONE MACHINE’ option. 
This option is invoked by a ‘Swap’ command and 
requires an expanded QL to run. Even now however 
Netwarking and Single User options can still be run on 
an unexpanded QL, 

To describe FTC II in full would take pages, so write for 
aaa Handbook - ‘A Look at Fleet Tactical Command 


Price: 3.5" Disk Version - 
MDV Version - 


£49.95 2 Masters supplied 
£56.95 4 Mdv's supplied 


SPECIAL OFFER 
Fleet Tactical Command V1.02 


A limited number of Version 1 copies are available on 
a ‘First come - First Served’ basis. Customers taking 
advantage of this offer can upgrade to Version 2 at a 
cost of £20.00. 

3.5" Disk - £29.95 


Special Price: 

MDY - £32.95 
This special offer is only available direct from DI-REN 
UK 


All FTC Packages include charts, scenario logs and 
geometry sets etc. 


The Fugitive 
Not flashy, easy or friendly is an excellent description 
forthis Text Adventure. You are a fugitive in Russia and 
have to leave in a Hurry! 
This will keep you occupied for weeks. 
Price: £9.95 
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Qram or Qpac |i because these products 
modify Qdos to improve the multi-tasking 
environment. Almost inevitably, if you in- 
tend to load more than one substantial 
executable program at a time your QL will 
need memory expansion. 

The commands to load and initiate an 
executable program are quite straightfor- 
ward. If the program is to work at the same 
time as other multi-tasking programs the 
command is: 


EXEC flp1_ filename 


If a number of programs are launched in 
this way they will share processing time 
and appear to be working independently 
and simultaneously. For programs which 
need keyboard input this can be a problem 
— which of the programs should respond 
to a particular set of keypresses? Which 
program is going to have first access to the 
printer, or the disk drive? Qdos has no 
simple answers to these questions, and so 
its multi-tasking environment needs to be 
tamed. 

The easiest way of preventing input and 
output clashes is to tell Qdos that the 
program being run takes full control of all 
device channels and processing time until 
it is finished. The command to do this is 
EXEC_ W, and its syntax is exactly the 
same as for its EXEC_ relative. The W 
extension means “Wait until terminated”. 
For the vast majority of executable pro- 


grams commercially available the EXEC _ 
W keyword should be used as a matter of 
course. Itis nervertheless worthwhile to be 
aware that under Qram and Qpac II the 
QL's multi-tasking environment is changed 
so that EXEC and EXEC_ W have the 
same effect. 

Super Toolkit 2 expands the EXEC fam- 
ily to include two more keywords, but their 
full potential is of more benefit to knowl- 
edgeable programmers than for 
non-programmers. However, for conven- 
ience use can be made of: 


EX Exactly the same as EXEC 

EW Exactly the same as EXEC_ W 

Turbo Toolkit provides EXECUTE, Ex- 
ECUTE_ A and EXECUTE_ W as other 
alternatives. These commands all allow 
more parameters than just a filename, but 
their use lies beyond this article. 

There are advantages which can be 
gained from the features of a multi-tasking 
program without necessarily running it si- 
multaneously with another program. The 
Psion business utilities bundled with the 
QL are all multi-tasking executable files 
which can all fit on a single disk, but only 
one of which can be loaded into a standard 
QL ram at one time. Nevertheless, a form 
of task-switching can take place provided 
that an appropriate boot file is constructed. 
The details of this boot file will be printed 
next month, along with many more useful 
and practical hints about boot files. 


Mini Process Controller 


The MPC is aremarkable VERY LOW COST switchgear 
unit thatcan be plugged into ANY computer's Centronics 
Interface (as commonly used on printers} and allows 
the user via very simple programming techniques to 
operate 6 make/break relays. 

This unit is of interest to hobbyists and professional 
users alike. Switch timings can range from 24 hour to 
split seconds, Its uses are numerous, from energy 
management to security switching and even switching 
off the portable TV! 

A major feature of the unit is the ability to connect it 
permanently in-line with the printer. The printer can be 
used without affecting the controller. 

For ease of compatibility sockets are fitted to the unit 
that any ‘Figure of 8’ plug'lead (usually foundon cassette 
recorders and so on) can be plugged in to, These are 
easily obtainable. One in supplied with the unit. 

The unit can be powered by 2*PP3 (or equivalent) 
batteries or by an optional UK type mains adaptor. 
Full instructions are supplied, ——~"--—__ 


a 


Prices: 

Mini Process Controller 
(Batteries no included) 

Spare connector leads 

1 Metre printer extension cable 
2 Metre printer extension cable 
UK re Mains adaptor 

QL MPC Utility 


QL MPC Utility programme 


This menu driven programme sets up and installs 
critical and long-term timing operations for the MPC. It 
can Save/Load data files and contains some useful 
Superbasic commands. 

A Small non-destructible on-screen display indicates 
the controller state, 


Di-Ren Network Prover 


This simple but invaluable device is essential for thase 
of you who regularly use the QL-QL network. Plugging 
it in between the connected QL's indicates, using an 
LED, whether transmission is taking place or if the 
network has ‘siezed up’ thus keeping you informed of 
what is actually happening. The price’ just £3.50. 


ane 
> 


Ice-Sense 


As a special offer to QL 
World readers our 
automotive product 

‘ICE SENSE ' is yours for 
only £4.95 


This electronic ‘Black Box' product is easily fitted to 
most vehicles with a 12 Volt supply and gives warning 
of impending ICY ROAD conditions. 


Availability 


DI-REN products are available from: 


Di-Ren 

43 Davids Road 
London 
SE23-3EP 

Tel 081 291 3751 


Ordering From DI-REN 


For Software orders state Disk or MDV. 

All prices inclusive of P&P (UK, Europe/EEC) 
Access/Visa telephone orders accepted. 

Cheques should be made payable to DI-REN. 
Clearly state your name, address and product required. 
Further product details available on request. 


QLympic eat a Systems 
Quellenweg 1 

4220 Dinslaken 
W.GERMANY 

02134/91766 
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AYOFTWARE FILES 
DOUBLE BLOCK 


Rich Mellor 
goes Russian in 
an old game 
brought up to 
date. 


Ts game is based upon 
a popular Russian game 
apes ‘Tetris’ which is 
in itself a simple, highly ad- 
dictive game. The idea of the 
game is that several different- 
shaped multi-coloured blocks 
fall from the top of a ‘pit’ on 
screen. These must be rotated 
and moved left or right so that 
they form a full line of blocks 
across the screen. Once a line 
has been completed, it disap- 
pears from the screen so that 
more lines may be formed 
within the ‘pit’. Should any 
line have a gap (or two) in it, 
this willremain onscreen, with 
the pit gradually filling up with 
incomplete lines. Once there 
is no more room in the pit to 
allow another block to be 
dropped, the game is lost. 

With the idea behind the 
game being so simple, the keys 
must also be simple. The left 
and right cursor keys move 
the falling blocks left or right, 
the up cursor rotates the block, 
and the down cursor makes 
the block drop more quickly. 
This is a straightforward com- 
bination which allows a 
joystick to be used if neces- 
sary. However, this version of 
the game also incorporates a 
two-player mode, where both 
players have a pit on screen, 
each with its own set of falling 
blocks. One player can use the 
cursor keys, while the second 
player really needs a joystick 
plugged into CTL2 (although 
the function keys F1 to F4 can 
also be used). 


Colour 


The display onscreen is well 
laid out with lots of colourful 
graphics, and even a little 
sound to keep you amused. 
Also shown on screen is your 
present score. There is an op- 
tion in the one-player mode to 


show the next block which will 
be dropped, so that you can 
plan ahead. Peculiar to this 
version of the game is an ex- 
tended graphics mode, where 
the blocks can be any one of 16 
shapes (the normal set features 
only seven). This extended 
graphic mode certainly makes 
the game much more difficult 
and should prove a challenge 
to the most practised Tetris 
player. 

Points are scored inthis game 
for each block which falls and 
each line which is formed. The 
game maintains a high score 

table, which on start-up con- 
tains some high scores 
achieved by the author: these 
are depressingly high how- 
ever, and you will be glad to 
learn that you can get rid of 
the current high scores at any 
time merely by deleting one 
file from your disk. 


Faster 


The game also features 10 
different speed levels; these 
can be different, if you are 
playing in two-player mode, 
for each player. However as 
you play the game, the speed 
of the falling blocks increases, 
so that with the screen slowly 
filling with incomplete lines, 
you soon begin to realise that 
your reaction times are much 
too slow. It was however nice 
to see that the speed increase 
is so set that in the two-player 
mode, if one player begins at 
speed 0 and the other at speed 
6, you will both reach speed 7 
at the same time! Still, if it all 
gets too much for you, a press 
of the ‘P’ key will pause the 
game while you get your 
breath back and decide just 
what to do with the mess you 
have made on screen. 

Inall the game isa most wel- 
come rest from the normal type 
of arcade game which appears 
all too readily on home com- 
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puters. This game requires 
thought, quick reflexes and an 
eye for opportunity. It reminds 
me of that old children’s edu- 
cational toy where they have 
to fit the different shapes into 
the different holes, the only 
difference being that here 
much more speed is needed, 
and a better eye for patterns. 
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Novice 


have just acquired an old 
QL, and as a complete nov- 
ice to programming have 
been attempting to write 
some software to make my busi- 
ness run more smoothly, There 
are however a few things that I 
have been unable to find out how 
to do. 


Mark Smith 
New Costessey 
Norwich 


A) How is it possible to have a key 
that can over-ride the program at 
any stage during the run, (same 
principleas the ESC key in Quill)? 


Pressing <CTRL & Spacebar> 
at the same time breaks a 
SuperBasic program atthe end 
of the current statement, giv- 
ing the error message At line 
NNN not complete. As with 
any error message there are 
then two commands you can 
type to get it going again: 
CONTINUE carries on just 
where the program left off 
while RETRY goes back and 
does the last statement again 
before continuing — this can 
be useful, as when you realise 
you have the wrong mdv car- 
tridge in the drive and want 
time to change it. You can 
sometimes actually EDIT aline 
and then RETRY, but this 
rarely works properly; it cer- 
tainly won’t work if you are in 
the middle of a PROCedure or 
FuNction, or any kind of loop; 
the program tends to forget 
where it was in these when 
you EDIT. 


B) Is it possible in one line to 
check that an input is numeric? 
(In order to stop a program crash- 
ing if a non-numeric amount is 
entered in a numeric variable.) 
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Technical 
Helpline 


A SuperBasic extension to do 
this, CHECKF, was described 
by Simon Goodwin in DIY 
Toolkit in the January 1989 
issue of QL World. This is now 
available on disk or mdv fora 
small fee. SuperBasic function 
can be written to do the same 
job, but it takes about 35 lines. 


C)} How is it possible to copyright 
a program (to stop other people 
being able to list it)? 


What [ think you mean is to 
copy-protect a program copy- 
right refers to the legality 
rather than the feasibility of 
making copies. There is not 
much you can do to prevent 
others from reading your 
SuperBasic listing, unless you 
compile it — there are three 
compilers on the market, and 
that does make it unlistable, 
but the compiled versions can 
still be copied. There are a 
number of tricks to make 
copying more difficult, but, 
particularly with disks a de- 
termined hacker can defeat 
them. However, since you ad- 
mit you are a beginner why 
would you want to do this? It 
is not very likely that you will 
immediately be able to write 


15 OVER(-1): 
20 FOR i=-0 TO 200 


30 END FOR i 
40 OVER OQ: 
50 DEFine PROCedure 


65 PAUSE(1): 


75 END DEFine 


Sprite Listing 


10 CLS: FOR i=0 TO 208: PRINT"Fred"; 
REMark XORs screen output 


25 Sprite i+5,50+50*SIN(PI*(i)/50) 


35 FOR i=205 TO 5 STEP -2: Sprite i,50 
REMark Normal printing again 
45 REMark ttt tt etna nnn 


55 LQCal c: c=7: REMark colour of sprite 
60 BLOCK 2,10,x,y,c:BLOCK 10,2,x-4,y+t4,c 
REMark To adjust speed 
70 BLOCK 2,10,x,y,c:BLOCK 10,2,x-4,y+4,c 


the ultimate QL program, and 
make your fortune! Fortu- 
nately many competent 
programmers are prepared to 
rely on the law of copyright 
and allow users access to their 
code. That is one of the ways a 
beginner can learn: study other 
people’s programs from 
wherever you can get them — 
MDX exchange, Quanta li- 
brary if youarea member (and 
any serious QL user should 
be), OL World listings, etc. and 
see how they do it. Once you 
find yourself saying, “Ican see 
a better way to do that,” you 
are on your way. 


Background 


Please can you tell me the com- 
mand which changes which part 
of the ram the screen is, also can 
you tell me how games writers 
stop the background graphics be- 
ing erased when the sprites walk 
over them? I am hoping to in- 
clude these in a Basic program. 


Peter Smith 
Middlesborough 

Cleveland 

Although Sinclair planned a 


Sprite(x,y)} 


Howard 
Clase picks 
up some 
readers 
questions 
about 
technical 
aspects of 
the OL. 


two screen mode for the QL he 
never implemented itin any of 
his versions of the rom. How- 
ever OView’s Minerva rom 
does have this facility along 
with many other improve- 
ments. 

True sprites require consid- 
erable expertise in writing 
machine code, but you can 
make use of the OVER -1 com- 
mand in SuperBasic to get a 
similar effect. This has the ef- 
fect of XORing any printing or 
graphics in a window against 
the background until the 
OVER command is used again. 
So that printing the same thing 
twice at exactly the same spot 
causes it to appear and disap- 
pear again, restoring the 
original background. Because 
it is in SuperBasic it won't be 
very fast. The short program 
in the listing illustrates the 
principle. 

The ‘sprite’ here is a simple 
cross which moves in a sinu- 
ous path over the text, returns 
straight to the starting point 
and then vanishes. The more 
complex your sprite the slower 
will be the movement. I've 
drawn the sprite twice within 
the PROC; this is faster than 
calling it twice from within the 
loop. It is best to design your 
sprite with the BLOCK com- 
mand if you can rather than 
with the graphics commands 
because they are also slower. 
Changing the parameter of the 
PAUSE command in line 65 
can be used to adjust the time 
the sprite spends on the screen, 
for maximum speed remove it 
completely. Use the variable c 
in the procedure to experiment 
with different colours. 


Rounding Up 


A German reader, Wilhelm 
Albrecht, has noticed that the 
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Listing 1 


CLS 
n=4.5*18.05 


PRINT Round(2,n) 


STOP 
REMark 


DEFine FuNction 


REMark p = 
LOCali m 
mo 


No. 


AR RAR AAR A KR ARR A AKA RAR AAA A AAA 


Round(p,n) 


of decimal places 


INT (n*10*(pti)+.5)/107(p+1) 


RETurn INT(m*10“pt.5)/10*p 


END DEFine 


standard ‘rounding off’ rou- 
tine behaves erratically when 
the digit being dropped is ex- 
actly 5. The SuperBasic 
formula for rounding a 
number N to p decimal places 
is: INT(N*10“%p + 0.5)/10“p, 
and Mr Albrecht has discov- 
ered that when N = 4.5*18.05 
rounding to two places the 
result (81.225) is rounded 
down to 81,22 instead of up to 
81.23 as he would like. He 


suggests adding 0.5001 instead 
of 0.5, but while this corrects 
this particular problem it 
would create new ones, 
rounding up numbers like 
18.7499999 when it ought to 
round them down, 

Like Mr Albrecht I was 
taught to always round up 
under these circumstances, but 
here in North America the 
convention — and that is all it 
is —is toround a5 to aneven 


D I 


TECHNICAL HELPLINE 


number. The argument is that 
this will randomly result in an 
equal number of up and down 
roundings, so that the total of 
a large number of rounded 
numbers will be more accu- 
rate than the total of a set 
produced by the European 
method. 


Binary 


The QL, like all digital com- 
puters, does all its calculations 
in binary, converting decimal 
numbers back and forth as re- 
quired; often there isn’t an 
exact conversion, but Odos 
does live up to Sir Clive’s 
promise of seven digit accu- 
racy,and Psion have been able 
to build twice that into their 
programs. Mr Albrecht’s 
problem arises from this bi- 
nary to decimal conversion 
error. The actual result of the 
OL’s calculation of 4.5*18.05 is 
81.22499994039536 which 


— 


EXAMPLE FOR NOT CORRECT ROUNDING 


MULTIPLYING NUMBER 1 


NUMBER 1 NUMBER 2 


1@ FIGURES BEHIND DEC.—POINT 


13.41 
13.41 
13.41 
13.41 
13.41 
13.41 
13.41 
13.41 


, . 
uuanauagd 


. 


QOntuUFrUNn 


TOTAL 3 


MIND THE MISTAKES 1 


TIMES NUMBER 2 


Ni # N2 


33. 5250000808 
44. 9350008000 
4B, 3450000000 
73. 75S58OS8000 
87. 14650000008 
100. 5758000080 
113. 7250800008 
127. 3958000000 


643. 6880080208 


Fields D12 to D2! are correct ! 
Field E2i s 643.68 ist not the sum of D112 to D119 as described in MANUAL 
But now look at fields 
Rounding up are not correct ! Mysterious things are happening. WY ? 
Type in to field D29 : 


—8. DUBHGOAIIS 
Type in to field DSi 1->D15-73. 755< 


Fil2 and FiS: 


>D12-33.525< 
ONOUBEHS 1784197 


17763568394 


Ni # N2 


2 F.B.DP 


643. 4B 


AND ROUNDING 


INT (N14N2 
#188+.5)/108 


5S F.B.DP 


33. 52088 
46. 94808 
68. 35008 
73. 75808 
67. 17008 
188. 58808 
113. 977000 
127. 40808 


33.53 
46.94 
468.35 
73.74 
87.17 
190.58 
113.99 
127.48 


643. 78028 


The same bug exists by using SUPER_BASIC without ABACUS !! 
One way to go round this 1 


Using the 


INT- Kommand don't only add .5, but .3@@1 after multiplying 


with 100,10080,1000@ etc. and before deviding through 180, 1908, 19000. 


May be there is a better way.If so,please tell it to me. 


To get this sheet ,the following formulas are used: 


AsAcuS GERMAN VERS 2.45 ROM VERS=NGG 
Bi2 ep=zle()-9.5 von 12 bis 19 
ciz sp=13.41 von 12 bis 19 
Di2 ep=Bi2#C12 von 12 bis 19 
E12 sp=B12#Ci2 von 12 to 19 
Fi2 sp=GANZZAHL (B124C12#106+.5)/188 


. von 12 bis 
D2i SUMME (D121 Di9) 
E21 SUMME (E123E19) 
F21 SBUMME (F123F 19) 


19 


ENGLISH may be 1 
col#line()-9.5 from 12 to 19 
col-13.41 from 12 to 17 
tol=Bi2eCi2 from i2 to 17 
col=B12"C1i2 from 12 to 19 


D29 and DSi 1 look above 


Wide of columns 


After looking THIS on your own screen,alter field Fi2 (.58@1 instead .5) 
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col=INT (B12#C12#108+.5) /10B 
from 12 to 19 

sum (Di21D19) 

sum(E121E19) 

sum(Fi2sF19) 


18 12 


Qdos correctly prints as 81.225 
to seven digit precision. Note 
that this is accurate to 9 fig- 
ures. (How did I find this out? 
Try PRINT 4.5*18.05 - 81.225 
and you will see the differ- 
ence.) The situation is similar 
in Abacus except that the 
arithmetic is “double preci- 
sion”. In both cases the INT 
function operates on the 
number actually stored in the 
QL’s memory and not the 
rounded value however 
meaningless the last 7 or 8 dig- 
its may be. 

When presented with a true 
exact 5 to round the formula 
does always round up, so Mr 
Albrecht can get the behav- 
iour he wants by a two step 
rounding: round first to three 
places and round the result of 
that to two; this still may fail 
very occasionally, but should 
be much more reliable, Listing 
one gives a SuperBasic 
FuNction that will do this. But, 
while I was writing and test- 
ing this, I discovered another 
problem, there is a limit to the 
argument of the INT function 
of + /-2147483647; values out- 
side this range generate errors 
both in SuperBasic and Aba- 
cus. It is thus possible to cause 
an overflow when dealing 
with large numbers or when 
rounding toa large number of 
decimal places. In SuperBasic 
this shouldn't be a problem if 
you remember the normal 
seven digit precision, but it 
could be a limitation for ac- 
countants using Abacus for 
dealing with multi-million 
budgets! 


Uncertainty 


The real point it that there is | 


no correct answer to this prob- 
lem, and in fact Qdos’s 
behaviour is probably better 
(more random) than either 
convention. The fact that you 


want to round implies thatthe | 


digits *being lost are 
innaccurate or unreliable (if 
they originate in a measure- 
ment) or irrelevant (if they 
result from an exact calcula- 
tion). You have to accept that 
some uncertainty still exists in 
the last figure and to minimise 
this you must work with at 
least one more significant digit 
than you really want, round- 
ing only at the very end. 
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nthe same way that many expensive 
high-spec cameras are only ever used 
for taking holiday snaps, scores of QL 
computer owners are only using their 
superb machines to carry out a limited 
range of work. It is worth taking another 
look at some of the many tests the QL can 
perform — and here are thirty of them just to 
start the ball rolling. 


PLAY GAMES - the obvious one, with 

plenty of software available ranging from 

| the many Quanta freebies such as Startrek, 

Dungeons, Duckshoot or Mastermind to 

commercials such as Microbridge which 

could set you back £35. Old favourites — 

| but still unbeaten — are Scrabble and, of 
course, Psion Chess. 


David Drysdale 
lists creative ways 
people have put 
their QLs to work. 
And yes, we would 
like to hear from 
readers who can 
add to the list. 


LEARN TO TYPE — something which 
very few people learn to do properly yet, 
once mastered, this skill will pay dividends 
throughout life. Try Touch Typist from 
Sector Software at £12. 


SET UP ASTAND AT A GARDEN FETE 
— plenty of fund-raising scope if you have a 
power source to get the QL up and running. 
Horoscopes and biorhythm charts are two 
possibilities. Software can be bought but 
for the fun occasion try concocting some- 
thing of your own. 


MAKE TITLES and GRAPHIC DISPLAYS 
for your slide show or video production. 
There are programs, at every level, every- 
where you look. 
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GET TO GRIPS WITH ARCHIVE - it 
really is an amazing piece of software 
once you get used to the procedures and 
Sedit screens. All will be revealed in Mike 
O’Reilly’s book Database Management 
on the QL if you are lucky enough to find 
a copy. Or try the Archive Tutor program 
from TK Computerware. 


PLAN YOUR HOUSEHOLD BUDGET 
FOR THE YEAR - there’s no finer way to 
learn the wonders of the Abacus 
spreadsheet. Once your budget is up and 
running ask some ‘What if?’ questions 
about your personal spending. The 
spreadsheet’s lightning recalculations 
may throw up some surprises. 


MAKE A COMPUTERISED CHRIST- 
MAS CARD LIST — on Archive, of course. 
You can bring it on screen each year and 
update it. Remember to record gifts sent 
as itis all too easy to send the same type 
of gift year after year automatically. 


BECOME A PRINTER - the variety of 
desk top publishing programs offered in 
Sinclair QL World should enable you to 
print like a professional. It won’t happen 
however without a printer's trained eye 
for type design. Look out for books and 
courses on the subject. 


KEEP A PERSONAL SPENDING AC- 
COUNT and discover why cash disap- 
pears so fast. Bank Account from SD 
Microsystems is well worth considering. 


Charity 


MAKE A CARD INDEX OF YOUR 
SLIDES AND NEGATIVES — again on 
Archive. Keep plenty of fields available 
for searches and to reduce cross-refer- 
encing. 


MAKE A GRAPHIC DISPLAY FOR A 
CHARITY — most charity stalls at fetes 
and fund raising fairs like something on 
the stall to attract attention. Ever chang- 
ing charts and graphs appearing on your 
screen will do just that. 


MAKE AN ADVERT DISPLAY FOR A 
SHOP WINDOW - if you can stand being 
without your QL for a week or so at sale 
time, ashopkeeper friend would be grate- 
ful to have the bargains displayed this 
way. 


HELP A CLUB WITH ITS MEMBER- 
SHIP LIST —clubs and small charities are 
always grateful for a computerised mem- 
bership list that can give up-to-date 
printouts. Check with the Data Protection 
people before you make a start though. 


MONITOR YOUR UNIT TRUSTS AND 


PRIVATISATION SHARES -— Investment 
Monitor by Michael Slatford is ideal for 
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this. (TK Computerware £20). And don't 
forget Easel 
graphs. 


for share performance 


DEVISE ASTOCK CONTROL SYSTEM 
FOR YOUR FREEZER - with shopping 
lists and an updatable printout to fix on 
the freezer door with a fridge magnet. 


MAKE A FAMILY MEAL PLANNER — 
with rotational recipes, and save the cook's 
constant worry about what meal to serve. 


GO ONLINE TO PRESTEL-—you'll need 
a modem of course; look out for the 
Tandata three stack modem which can 
sometimes be obtained from Quanta at 
an advantageous price. There are hun- 
dreds of information providers plus com- 
puter clubs, an agony aunt, an AIDS infor- 
mation service and a Gay line. 


BOOK A CHEAP HOLIDAY — again 
through Prestel. Many travel agents have 
cancellations and last minute bargain of- 
fers and Prestel is the ideal medium for 
picking them up. 


OPEN A COMPUTERISED BANK AC- 
COUNT — you'll need the modem to see 
your bank statements on screen and to 
make instant cash transfers between de- 
posit and current accounts. Pay all your 
bills from the keyboard and pick up a bank 
statement from your printer whenever you 
like. Contact: Home and Office Banking 
Service, Bank of Scotland, 2 Robertson 
Ave, Edinburgh EH11 1PZ. 


TIME YOUR PHONE CALLS AND 
KEEP BILLS DOWN - lots of scope here 
for designing a program to keep track of 
the time of day, length of call and the cost 
of each unit. A discreet little beep for 
every 50p spent might be a good idea too. 
For people who are not too advanced in 
programming aready made call timer can 
be had from Quanta. This is quite good, 
but screams out for further development. 


MAKE A POOLS FORECASTING 
PROGRAM - there are plenty of basic 
coupon marking systems around includ- 
ing those issued by the pools companies 
to act as a basis. You can buy one 
readymade of course. Advertised occa- 
sionally in QL World. 


BECOME A RADIO OPERATOR - 
wireless telegraphy using morse code 
has not been totally eclipsed by modern 
techology. Radio enthusiasts can still send 
messages round the world using minus- 
cule wattage and need to show morse 
proficiency to get a full long wave licence. 


HELP A LOCAL ELECTION AGENT 
ORGANISE THE CANVASS - lists and 


30 THINGS TO DO 


more lists, of course, both for pinning on 
the walls and handing out to the canvass- 
ers. Archive, especially with a disc drive, 
should be able to handle it. 


BECOME A MUSIC COMPOSER — the 
QL is possibly not the best computer on 
the market for this purpose but Miracle 
System's Midi music interface is said to 
be having software redevelopment and 
could be on the market soon. 


CHECK YOUR WINNINGS - write a 
program for checking betting shop win- 
nings. Programs can be bought of course. 
Especially useful if you bet by phone and 
need the information instantly available. 


BECOME SELF EMPLOYED — Quill, 
Abacus and Archive have all the capacity 
needed to handle your paperwork. For a 
one-man business General Ledger from 
SD Microsystems makes accounting a 
doddle. If you are on the dole don’t forget 
the Enterprise Allowance. Freebie help is 
available too in deciding what business to 
start. 


MAKE A DAY PLANNER WITH AUDI- 
BLE REMINDERS — no reason why this 
job which is done by electronic pocket 
organisers should not be done on a static 
QL for people who work from home. You 
are on your own with this one however as 
no commercial program seems to be 
around. 


DESIGN A CALORIE COUNTER - 
slimmers can find plenty of calorie data to 
inputinto a program to count up the day's 
tally. There is probably a program around 
to do this but | haven’t spotted it. 


Shopping 


USE YOUR MODEM TO GO SHOP- 
PING — Compustore Online provides a 
direct cut price shopping service with 
delivery to your door (ring 0753-868191 
for details). Prestel also lists businesses 
that supply everything from vitamin tab- 
lets to home-delivered flowers. 


SEND ATELEX ACROSS THE WORLD 
— again through Prestel. Their Telex Link 
service allows your computer to output a 
message that can be delivered anywhere 
that the teleprinter network reaches. You 
can also send freebie messages directly 
to other Prestel users by the mailbox 
service. 


Finally, as an extra suggestion, how 
would you like to ADD TO THIS LIST. The 
pooled knowledge of readers of QL World 
could probably increase it a hundredfold. 
The Editor, | am sure, would like to see 
your ideas. 


shall now reveal the inner workings 
of the CLIP functions, introduced 
last issue, suggesting more uses as 
| explain the code and its ramifica- 


tions. 

For years | have wanted a ‘clipboard’ 
that can read characters from the QL 
screen, and type them into any other—a 
kind of OCR for QL Windows, to save me 
| from ever having to read and re-type what 
the QL already ‘knows’. Atlast I've done it, 
and the listings show how. After years of 
conditioning | couldn't resist the tradition 
of QL puns, and dubbed it Qlipboard. 

Qlipboard can scan Qdos or Argos to 
find and identify all screen and console 
windows. It reads special attributes like 
character-size and fonts from the window. 
With this information the scanner can read 
or test lines or individual characters, and 
scoot around any window. 

The editor lets you check or change the 
clipped text; it can be called up atall times, 
in its own pop-up window. Text is held in 
string pages of up to 32K; the routines 
listed share data space between ten 
pages. 

The only importantthing about Qlipboard 
is to remember to load it. You will keep 
new finding ways to use it. | mis-typed a 
line-number while programming it, and 
lostalong PRINT line from the listing. I still 
had the latest version in the output win- 
dow, so | just clipped the characters and 
fed them straight back into ED. 


Squirt 


To copy various bits into one SuperBasic 
procedure, LIST the lines containing the 
bits, clip them up and squirt them back into 
Basic somewhere else. It’s similarly easy 
to squirt text into Quill, Archive, editors, 
emulators and just about any other task 
that lets you type lines into it. 

Qlipboard was written in response to 
years of suggestions from QL users. It is 
not a replacement for existing facilities, 
but can be an alternative. Often it fills a 
gap in the QL armoury, allowing figures, 
| code and text to be transfered accurately 
between tasks. As well as text, it can 
easily transfer hex data, Archive proce- 
dures, Abacus formulae, SuperBasic or 
other programs, Ease/ labels andso on... 
Qlipboard can envigorate slothful edi- 


DIY 
TOOLKIT 


tors. Psion and Metacomco block copy 
operations are painfully slow and limited. 
Itis often easier to clip characters from the 
screen, go to the new place directly, and 
spit the text back into the file. 

Qlipboard does not obscure the screen 
while scanning, but it only reads one 
screenful at a time. When you've scanned 
all you can see without satisfaction you 
must page the task’s display and scan 
again. Swapping can use a single key- 
press. The editor can cope with up to 32K, 
so you can extract 500 lines or more, a 
screen at a time. 


Qlipboard can pick up past lines from 
the command window, but Super Toolkit’s 
Alt Enter may remember more, depend- 
ing on line length. It works if the text is still 
visible, even when Alt Enter would be 
confused by single key choices, arrows or 
deletions, or ESC is pressed accidentally 
on Minerva, denying the line to ALT Enter. 
| use both, and find Qlipboard most useful 
when past attempts warn me that Alt Enter 
has reached its limit. 

CLIP% and CLIP$ can recognise user- 
defined graphic characters as well as text. 
They are useful accessories for games 
writers and converters who miss Spec- 
trum functions like SCREEN$ and ATTR, 
often used to detect collisions in interac- 
tive animated sequences. 

The Clip functions are also suitable for 
quick printouts of text displays. Now you 
can scan characters from the screen, and 
translate their codes before printing, if 
need be. Most printers give best results 
from a stream of Ascii text. Shaded bit- 
image graphics tend to be slow and streaky 


Simon Goodwin 
shows how to 
transfer text 
between console 
windows, and 
demonstrates the 
CLIP functions for 
the OL and Thor. 


by comparison. 

Routines to search fonts quickly and 
pack any character from the screen into a 
nine byte font pattern are imbedded in 
Listing two. You could scan graphics into 
a font, and PRINT two colour patterns of 
any width, up to nine (or 18) pixels high. 

Qlipboard recognises four extra key- 
strokes while other tasks are using the 
keyboard. The codes are configurable by 
editing; the names are stored in Ascii text 
in the compiled task, with easily-recog- 
nised labels like ‘““=EDIT’ after each 
decimal code number. Even after compi- 
lation you can change the codes with 
utilities like The Editor, Spy or FEDIT, by 
patching new digits into the file. You could 
use LBYTES, PEEK, POKE and SEXEC, 
but SEARCH MEMORY would savetime. 
Just replace the stored codes with your 
own choices, 0-255. 


Codes 


| prefer to assign the Qlipboard to ‘con- 
trol’ codes, 0-31, or non-display codes 
192-255, as most tasks ignore them. This | 
discussion assumes the keys set in List- | 
ing 1. 

Control E calls SHOW_BUFFER, the 
clipboard Editor, saving the previous 
screen if RAM permits, before displaying | 
various options and the current clipped | 
text. You'll need to change this code if you 
need Spellbound turned on at the same 
time, as Control E calls up its examples. 

Control P types the next line from the 
clipboard page into the current task, as if 
you typed them yourself. The first line is 
‘next’ after the last. The computer burps 
briefly if it can’t find anywhere to put the 
characters. 

Each page can hold up to 32K of text, 
about 400 lines, but 3K is usually plenty. | 
You can have many’pages on one board, 
and this helps me keep text from different 
windows apart. This program allocates 
ten pages, unless you change line 1140 in 
Listing one. To swap between pages, 
call up the editor, press P then enter a 
digit, 0-9 

Control W highlights each window in 
turn, so you can select a default. The | 
highlight changes the colours on the 
screen, but Qlipboard can still recognise 
them all. Change ““=HIGHLIGHT” (List- 
ing one, line 1330) if you don’t like my 
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choice; the range is 0 to 255, and the 
effect depends entirely on the background 
colours, 7 and 2 are good alternatives; 17, 
34 and 222 are interesting. Press Space 
to highlight another window, Enter to pick 
this one, or Esc to escape changes. 

Control G turns on a ‘clip cursor’ in the 
default window so that you can clip text 
from it. If the default is not the window you 
want, press Enter or Esc to turn off the 
clipper and pick another window with 
Control W. 

You may clip text while a window is 
highlit, but you are meant to use Control W 
to pick a default. Visibility is improved and 
the cursor size is updated if you press 
Enter to confirm the selection, then Con- 
trol G to Get text from the window while it 
is displayed in its usual colours. 

Qlipboard hasits own cursor; you specify 
the characters that you want to clip by 
moving the cursor over them. This is con- 
trolled by the DIALOGUE routine, which 
recognises a score of auto-repeating key- 
strokes. 


Cursor 


The four arrow keys move the cursor 
one space at a time, in character-sized 
steps. You can't move the cursor outside 
the current window. Alt-Left and Alt-Right 
move quickly to the start or end of the line. 

Shift keys control reading. Shift Right 
reads the character under the cursor, if 
possible, and adds it to the current clip- 
board page, then moves the cursor one 
place to the right. Control Left and the 
Thor's grey arrow key move to the left and 
remove one character from the buffer. 
Control E displays the contents of the 
current Qlipboard page. 

Shift Enter scans all characters to the 
end of the line, and puts them on the 
clipboard, followed by an Enter character. 
Shift Space is similar but adds a space at 
the end of the line. In either case the 
cursor ends up atthe start of the next line, 
if any. 

Last month’s demonstration routine 
stripped out duplicate spaces in a line, so 
that text clipped from a Quill screen was 
not plastered with spaces added by justi- 
fication or centring. Sometimes margins, 
tabs and ‘extra’ spaces are significant, so 
SCAN_LINE in this month’s listing illus- 
trates verbatim scanning, and recognises 
extra spaces. 

The disk Qlipboard has both routines, 
so you can retain or ignore spaces after 
the firstin each group. If the scanned line 
consists of nothing but spaces it is con- 
densed to asingle Enter character, which 
gives the same result more economically. 
Sometimes the default cursor grid does 
not match the position of text; you may 
find this if you try to read pixel-positioned 
labels from diagrams. If text has scrolled 
or been placed with CURSOR you might 
have to nudge the cursor to get it right on 
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1000 
19010 
1020 


1030 : 


1640 
1050 
10690 
1070 
1080 
1090 
1100 
L110 
1120 
1130 
1140 
1150 


DIY TOOLKIT 


REMark @L GLIFBOARD by Simon N Goodwin and Phil Spink 
REMark Version 6.7; Exts: TURBO TOOLKIT 2, Q@BASE, CLIP 
IMPLICIT® w.c,key,windo :DATA_AREA 32 :REMark Needs #1 


REMark *#4#* QL & Thor keyboard-specific stuff 
sv_arbuf=SYSBASE+138 :REMark Key store address 
sv_keyq=SYSBASE+76 :REMark Pointer to key queue 
REMark Keycodes are ASCII for ease of patching 
Pickey%="23 *=Windows" :REMark Control W 
stuffkey%="16 *=Paste line” :REMark Control P 
clipkeyX="7 *=GET text" :REMark Control G 
edkey%= "5 A=EDIT" :REMark Control E for Editor 
REMark #*#4* Window & page configuration 
underline%=0 : getsize=1 : page%¥=O0 -: max_windows%=60 
maxpage%-9 : REMark MAXPAGE%+1 pages 

IF COMPILED : maxline%=2300 : ELSE maxline%=120 


1160 : 


1170 
1180 
1190 
1200 
12106 
1220 
1230 


1240 : 


1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1406 
1410 
1420 
14306 
1440 
1459 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1589 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1686 
1690 
1700 
1710 
1720 
L730 
1746 
1750 
1760 
1770 
1780 
1790 
1800 
16810 
1820 


REMark **** Grab space for data & window details 

DIM xshift®( max, windows%). yshift%( max. windows%) 

DIM height%(max_windows%), width%{max_windows%} 

DIM base(max_windows%), enter$(1),space$(1),newline$(1) 
DIM Esc$(1}.Lined( max] ine®), Paget(maxpage%, max] ine%) 
enter$=CHR$( 10} space$=CHRS( 32) Esc$-CHRS( 27) 
newline$="\"  :REMark Symbolic Newline, suits I0,EDLIN 


WINDOW 512,256,0,0 
WINDOWS :FIND_MYQ :Line$="Qlip 6.7\":cpos%=1:windo=0 
REPeat indefinitely : PICK_WINDOW : POLL 


DEFine PROCedure PICK WINDOW 
LOCal paper%, selected, prior 
REMark Result is global WINDO {0 .. global CH®% - 1} 
WINDOW 512,256,0,9 : selected=9 :REMark Clip Window 
paper’= 4 *-HIGHLIGHT" :REMark XOR 222, 2, 17, 34 
WINDOWS 
IF windo<wink :first=windo :ELSE first=0 :REMark Guess 
REPeat tilpik 
FOR windo=first TO win%-1 
SHOW_WINDOW windo, paper% 
DIALOGUE windo, selected 
SHOW WINDOW windo, paper%® 
IF selected<O AND windo<>first 
SHOW_WINDOW first, paper% 
SHOW_WINDOW first, paper® 
windo=first :REMark Reminisce 
END IF 
getsize-(selected<>0} :REMark New CSIZE? 
IF selected :EXIT tilpik 
END FOR windo 
first=-0 
END REPeat tilpik 
END DEFine PICK WINDOW 


REFERENCE happy 
DEFine PROCedure DIALOGUE( win, happy} 
LOCal key, endx®, endy%, x%, y¥ 
REPeat getspec 
IF getsigze 
stepx%=PEEK_ W(base(win)+38) 
stepy%=PEEK W{base(win)+40) 
END IF 
CSIZE {stepx® DIV 4)-1,stepy%#>19 
POKE_W my. window+38,stepx¥® : UNDER underline% 
POKE_W my.window+40, stepy% : SET. MY@ 
POKE_L my_window+46, PEEK_L{ base(win}446) 
POKE_L my_window+50, PEEK_Li base{win}+50) 
endy4=yshift# (win) +theight%(wint-stepy® 
endx¥=xshift&’( win) »widbh%(win}-stepx% 
xhoxshift%(win) yR=yshifteiwin) REMark Top Left 
REPeat seek y 
CURSOR x%, ¥y%:CURSOR..ON #1!:key=CODE( INKEY$(#1,-1)) 
SELect ON key 
=192,194 :REMark Move left and maybe delete 
IF key=194 
IF LEN(Line$) :Line#=Lineg$(1 TO LEN{Line$)~1L) 
END IF 
x%-stepx# >= xnshift*%( win) xeH=XE-StepKm% 
-€04 :REMark Move right and maybe clip 
key=204 : Linet=Line$ & CLIPS (41) 
xé+stepx® <= endx® : x¥=x¥+stepxk 
:REMark Move up one character line 
yA-stepy® >= yshift%#(win) : ¥X=yH-stepy% 
=216 :REMark Move down one line 
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1830 
1940 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
1960 
1970 
1980 
1999 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2060 
2090 
2100 
2110 
2120 
2130 
2140 
21590 
2160 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 
2380 
2380 
2400 
2410 
2420 
2430 
2440 
2450 
2460 
2470 
2480 
2490 
2500 
2510 
2520 
2550 
2540 
2550 
2560 
2570 
2586 
2590 
2600 
2610 
2620 
2630 
2640 
2650 


IF y%¥+stepy® <= endyv% : y%=y%+stepy’ 

=197 :REMark Pixel shift left 
IF x%¥oxshift®( win) xK=xR- 1 

=205 :REMark Pixel shift right 
IF x%<endx% xH%=x%+1 

=213 :IF v¥>oyshift®(win) :y%¥=y%-1 :REMark Bit up 

=?21 :IF y¥<endy&% :y%=v¥%4+1 :REMark Down a bit 

=193 : x¥=xshift%®(win) :REMark Zoom to start/end 

=201 : x%=endx® - (width%(win) MOD stepx%) 

=fne, 254 SCAN_LINE 

=63 : BEEP 500,0 temp%=CLIP%( #1) 
REFeat Intel IF NOT BEEPING : 
IF temp%<O : BEEP 1000, -temp% 

=232, edkey% REMark F1/Edkey = Editor & options 
CURSOR_OFF SHOW_BUFFER : NEXT getspec 

=10,27,32 : REMark Enter confirms, SPACE = Next 
happy=(key=10)-(key=27} 
CURSOR_OFF : EXIT getspec 

END SELect 
END REPeat. seek 
END REPeat getspec 
END DEFine DIALOGUE 


REMark “?" 
EXIT Intel 


DEFine PROCedure SCAN_LINE 
REPeat scan 
IF LEN(Line$)<maxline® : Line#=Line’ & CLIP#(#1) 
IF x¥4+stepx% <= endx*® : xk%=x%t+stepx® ELSE EXIT scan 
CURSOR x%,¥% : CURSOR_ON #1! 
END REPeat scar 
IF key=252:Line$=Linet&spacet :ELSE Linet=Linetkentert 
IF y¥+stepy% <= endy% :x%=xshift# (win) :yh=yk+stepy% 
END DEFine SCAN_LINE 
DEFine PROCedure SHOW BUFFER 
REMark LOCal mem; DEALLOCATE MEM after BREAK tests 
vdu_lines=256 :vdu_start=131072 :REMark Screen 0 
mem=ALLOCATION( vdu_lines#*128) :REMark Screen buffer 
IF mem>0O :MOVE_MEMORY vdu_start TO mem, vdu_lines*128 
CLS :UNDER O :INK 4 :CSIZE 1.0 :AT 1,0 :PRINT Lines 
REPeat opt 
SET _MYQ : OPTIONS editor : IF editor=0 : EXIT opt 
XCHANGE Lines, enter$,newline$:CSIZE 1,0: INK 7:AT 1,0 
CLS 3:CLS 2 :LineS=EDIT#(#1, Line$,maxline%) :cpos*=1 
XCHANGE Line, newlines, enters 
END REPeat opt 
IF mem>0 
MOVE _MEMORY mem TO vdu start, vdu_lines#128 
DEALLOCATE nem 
END LF 
END DEFine SHOW _BUFFER 


REFERENCE txt$ 

DEFine PROCedure KCHANGE(txt$, old, news) 

LOCal pm 

REPeat. swap 
p¥=old$ INSTR txt 
Lt Bi p% ) =news 

END REPeat swap 

END DEFine XCHANGE 


IF p%¥=0 : EXIT swap 


DEFine PROCedure POLL 

LOCal key, keyq, pos%, not space 

REPeat dose 
key=PEEK_.Wi sv arbuf} 


IF key=pickey% : SET_MY@ : EXIT doze 
IF key=edkey% OR key=clipkey% 
keyq=PEEK_Lisv_keyg) 
REPeat clipk 
IF key=edkey®% : SHOW_BUFFER : EXIT clipk 
DIALOGUE windo, not_space: IF not_space: EXIT clipk 
END REPeat clipk : REMark Await ENTER/ESC 
IF NOT windo_offset : POKE_L sv_keygq, keyq 
END IF 
IF key=stuffkey% AND LEN(Line$)>0 
POKE_W sv_arbuf,0O : REMark Cancel auto-repeat 
nextpos%=enter$ INSTR Linet(cpos% TO LEN(Lines)} 
IF nextpos%>0 
STUFF Line$(cpos® TO cpos#+nextpos%—1) 
cpos%=nextposk+cpos% 
IF cpos*%>LEN(Lines} 
ELSE 
STUFF Line$(cpos% TO LEN({Line#é}} cpos%=1 
END IF : NEXT doze : REMark Dream furiously 


cpos%=i 


ET 


top of a character, so that CLIP can rec- 
ognise it. Press Shift and Alt at the same 
time as any arrow to position the cursor 
precisely in the window. 

The smallest text normally has one blank 
column on the left of each character, and 
one blank row at the top. You can test a 
position by pressing “?"; Qlipboard tries to 
read the character under the cursor, and 
bleeps once if successful; two beeps mean 
that the pattern was not recognised in 
either font for that window; you may need 
to move the cursor slightly. 

If the window uses more than one CSIZE 
you may need to over-ride the default for 
Control G, which is the most recent size 
set. Call up the editor and type X to change 
the width, or Y to set the height. A cursor 
appears above the old value. Standard 
values are 6, 8, 12 and 16, for X, and 10 or 
20 for Y. The new setting persists until you 
change it or select a window with Control W 
and Enter. 

Once you have finished clipping text, 
press Enter or ESC to turn off the clip 
cursor. If you forget to turn off the scanner 
you may confuse it with another task, and 
have to skip past it when swapping cursors 
later. Control P will not work while the clip 
cursor is active, but you can call the Editor 
directly from the clipper by pressing Con- 
trol E, or F1 for ‘help’. 


Taskforce 


Users running Taskforce or other tools 
that use standard Qdos windows will find 
that Qlipboard swaps keyboard queues 
automatically. Pick the task's cursor and 
press Enter after loading, so Qlipboard 
can identify its own queue and get started. 
POKE SYSBASE+146,9 if you prefer to 
use TAB instead of Control C. 

Qlipboard works very well with Task- 
master 2.35 despite its quirks, like nine 
pixel tall names in the ‘Files’ display. You 
can clip from all the windows, as long as 
characters and border lines don’t overlap. 
Note that the ‘Info Box’ display puts the 
date on line 6 of the Qlipboard editor, and 
the ‘Notebook’ accepts control codes. 

Systems with ‘extended’ console software 
must rely on their own devices when it 
comes to. queue swapping. Qlipboard 
needs to be able to move a cursor over the 
windows of other tasks, but Qpac-2 pre- 
vents this by ‘locking’ windows so you 
cannot see through them. 

This makes trouble for DIALOGUE 
(1540), even when 'EXEP’’U’ ensures an 
unlocked window. Qlipboard takes careful 
account of QPac's changes to Qdos 
channel usage; the editor and ‘stuffer work 
fine, and the Clip functions happily read a 
task’s own windows with Qpac loaded. It is 
a pity that current versions separate task 
displays in such an inflexible way. 

The Thor is more accommodating, if you 
POKE SYSS_VARS +133, -1 before start- 
ing, to discourage Argos from grabbing the 
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display and cursor at odd moments. Press 
the Sys Req key to swap keyboard queues 
as necessary; two taps returns to Xchange 
from Qlipboard, with Thor Basic running 
alongside. 

The Thor's PC keyboard gives standard 
codes whether or not you press Shift with 
Space or Enter. This eases typing but 
means Argos users must press Control 
Enter or Control Space to scan lines; these 
return the same codes as their shifted QL 
equivalents. Qdos treats Control Enter like 
Enter, or Control J, while Control Space 
corresponds to the Thor's Break key. 

Qlipboard clones the fonts in each win- 
dow, and uses them in the editor, so you 
see the same characters in the editor as 
you saw on the task display, as long as the 
task has not gone, taking the font with it! 
This feature suits the multi-fonted Thor 
XVI, and also helps to decode horrid games 
fonts. If you must know what it really says, 
clip the lines, pick a standard window, and 
consult the Qlipboard , to see the text in 
normal letters and colours. 

You could add code to load Psion’s sub- 
scripts font, or others, when several fonts 
are used in a window and you can't be sure 
which is current. MODQUILL, on Quanta’s 
Psion 7 \ibrary disk, should help, but | have 
been scolded for ‘doing it all’, so I'll stop 
there. 

The Qlipbboard editor uses CSIZE 1,0 
text to suit all Qdos fonts. The full window 
can be reduced for a tv, but Listing one 
uses the same window for clipping as for 
editing. The menu needs MODE 4, unless 
you change the column numbers in OP- 
TIONS or CHOOSE. 

TurboQuill Plus uses fixed internal fonts 
which match the Thor default, rather than 
the characters indicated by QL channel 
definitions. The letter f is narrower than on 
the QL, and the second column of k is 
lower. This means that CLIP% and CLIP$ 
cannot recognise the letters k or f, or some 

| non-Ascii characters, from QL TurboQuill 
Plus displays. The Thor is fine, as its fonts 
always match the screen. 


Minerva 


A keen Minerva user could fix this by 
extracting the TurboQuill characters with 
the A1 return from CHAXTOP, which re- 
turns the font pattern for any character on 
screen. Build up and set new default sys- 
tem fonts, if you are determined to Qlip art 
from TQ+ without nagging doubts! 

Type X, Y or U to change the character 
options after calling up the editor. Set 
UNDER 1 to read underlined text, or UN- 
DER 0 to distinguish underscores from 
spaces. 

Normally Qlipboard picks up the charac- 
ter-size from the window channel definition; 
thus it is not limited to the eight standard 
CSIZEs. In fact it copes with single or 
double height text with any Y step 0 to 49, 
and X steps from 4 to 19. If windows have 
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2660 
2670 
2680 
2690 
2700 
2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 
27390 
2800 
2810 
2820 
2830 
2840 
2850 
2860 
2870 
2880 
2890 
2900 
2910 
2920 
2930 
2940 
2950 
2960 
2970 
2980 
2980 
3000 
3010 
3020 
3030 
3040 
3050 
3060 
30790 
3080 
3090 
3106 
3119 
3120 
3130 
3140 
3150 
3160 
3170 
3160 
3190 
3200 
3210 
3220 
3230 
3240 
3250 
3260 
3270 
3280 
3290 
3300 
3310 
3320 
3330 
3340 
3350 
3360 
3370 
3380 
3330 
3400 
3410 
3420 
3430 
3440 
3450 
3460 
3470 


DIY TOOLKIT 


REMark Encourage other tasks | 


DEFine PROCedure STUFF (texts) 

LOCal status%, pos% 

pos%=1 

REPeat g_all 
status%=QUEURS( text${pas% TO} 
iF status%®=0 EXIT q_all 
IF status%=LEN{ text) BEEP 500, 127 EXIT q_all 
IF status%®<0O : status%=-status®% : REMark Stuffed 
pos%-1+LEN(text$}-status%® 

END REPeat q_all 

END DEFine STUFF 


END IF 

SUSPEND TASK 15 
END REPeat doze 
END DEFine POLL 


DEFine PROCedure SHOW _WINDOW( w, c) 
LOCal half% 
OVER -1 IF w<=5ll1 
BLOCK widthX¥(w). height%(w), xshift®(w), yshift®(w),c 
ELSE 
half%=w DIY 2 :REMark Avoid Sinclair’s BLOCK 512 bug 
BLOCK halft%, height%’(w)}, xshift®(w), vshift%(w), c% 
BLOCK half%, height%(w), xshift%(w)+half%, yshift*tw),c 
END IF : OVER 0 


END DEFine SHOW WINDOW 


DEFine PROCedure WINDOWS 
LOCal chbas, chmax, ch, chp, addr 
REMark Fill arrays ete. with 0.,WINK-1 window details 
windo_offset=CHANNEL ID(#1) :REMark Check channel 
windo_offset=windo_offset—INT( windo_offset/2°16)#*2°16 
my_window=CHBASE( #1 } chbas=PEEK_L{SYSBASE+120) 
channelO_driver=PEEK_L{ PEEK_Lichbas)4+4) 
windo_offset=chbas+4*windo_offset 
windo_offset=my_window-PEEK_L{windo offset) 
chmax=PEEK_W(SYSBASE+114) win%®=0 
FOR chp = chbas TO (chbas+chmax*4) STEP 4 
IF PEEK{ chp)<>255 
addr > PEEK Lichp) 
IF addr+windo_offset=my_window:NEXT chp:EXIT chp 
IF PEEK. L{ addr+4)=channelO_driver 
addr = addr+windo_offset : REMark Skip extras 
base(winté) = addr 
width%(win®) = PEEK W({addr+28) 
height%{win%)= PEEK _W{addr+30) 
xshift%(wink®)= PEEK _W{ addr+24) 
yshifta(wink®)= PEEK_W( addr+26) 
IF wink%<max_windows® 
winkt=wink4 1 
ELSE EXIT chp : 
END IF : REMark Room for details 
END IF : REMark Something like #0 
END IF : REMark Open channel 
END FOR chp :REMark WINDO_OFFSET, WIN%, MY_WINDOW set 
END DEFine WINDOWS 


DEFine FuNetion CHAN_ID(num%) 

RETurn CHANNEL, [D( #num%} REMark TURBO Toolkit 
REMark DIY TK: RETurn BPEEK_L{ BPEEK_L(48)+num%*40} 
END DEFine CHAN_ID 


DEFine PROCedure FIND_MYO 
PRINT "Qlipboard:"; 
REPeat snoop 
CURSOR_ON #1! Line$=INKEY#(#1,—-1) 
myq=PEEK Lisv_keyq} IF myg EXIT snoop 
END REPeat snoop : CURSOR_OFF . 
END DEFine FIND_MY@ 


DEFine PROCedure SET_MYQ 
CURSOR_ON #1!: IF NOT windo_offset 
END DEFine 


>POKE_L sv_keya,myq 


REFERENCE edflag 

DEFine PROCedure OPTIONS( edf lag) 

LOCal k#(1) 

STRIP 4 :CSIZE 0,0 : INK O :AT 0,0 

PRINT " Qlipboard 1990 SNG+PRS “; :STRIP 0 
PRINT “ Edit Page=";page%;" Guit RAM="5 
PRINT maxline%-LEN(Line$};" ";:AT 0,59:PRINT “Under="; 


/INK 4 


29 
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3480 PRINT underline%;" X=";s 
3490 REPeat keys 

3500 AT 0,83 : CURSOR_ON #1! 
3510 
3520 
3530 
3540 
3550 
3560 
3570 
3580 
3590 
3600 
3610 
3620 
3630 
3840 
3650 
3660 
3670 
3680 
3690 
3700 


IF k$=="e" 
IF k#=s="u" 
IF k$=="p" 
Page$( page%)=Line$ : 
Line$=Page$( page%) 
END IF 
IF k$=<"x" 
IF k$==s"y" 
IF k$=="2" 
END REPeat keys : 
END DEFine OPTIONS 


OR k#=space$ 
CHOOSE 65, 


: CHOOSE 70, 
: CHOOSE 75, 
: Lineg="" 
CURSOR __ 


REFERENCE thing% 
DEFine PROCedure CHOOSE(p 
LOCal entry$(2} 
REPeat get_entry 
AT 0O,place®% : INPUT ent 
TF entry#="" : EXIT get 
thing%="0" & entry$ : I 
3710 IF thing%>=1o0% AND thin 
3720 END REPeat get_entry 
3730 END DEFine CHOOSE 


IF k$="q" OR k$=Esc$ OR k$=enter$: edflag=0:EXIT keys 


: edflag=1 


: edflag=1 


tepx%;" Y="j;stepy%;" Zap "3 
: Ké=INKEY$( #1, -1) 


:edflag=1 : EXIT keys 
under Lline%, 0, 1 


CHOOSE 39. page%, 0, maxpage% 
: EXIT keys 


stepx%,4,19 : getsize=-0 
stepy%,0,49 : getsize=-0 
: EXIT keys 
OFF 


lace%, thing%, 1o%, hi%) 


ry$; 

entry 

F thing%<10 : PRINT “ “; 
2%<=hiX% : EXIT get_entry 


_| 


moved, remember that a window of 
512x256a0x0 can scan any Qdos text, 
anywhere. 

Listing one shows Qlipboard 6.7, about 
16K of interpreted or compiled SuperBasic. 
It uses Turbo Toolkit plus DIY Toolkit’s 
QUEUE, BASE and CHAN functions. | 
have tried to use ‘core’ Qdos facilities 
whenever possible, so programmers should 
be able to get it working with any common 
mixture of Toolkits. 

Line 1020 holds Turbo compiler direc- 
tives, like the REFERENCE lines before 
some definitions. The program can be in- 
terpreted without them. Line 1150 adjusts 
the size of the ‘page’ buffer; the interpreter 
needs MAXLINE%=120 to keep EDIT$ or 
EDLINE$ inside the minimum size of the 
SuperBasic buffer. Load or enter a long 
line to expand the area—or compile the 
program. 


Windows 


WINDOWS fills four arrays with the posi- 
tion and size of every window, as well as 
the base address of each channel's defini- 
tion (DIY Toolkit Volume C). Adjust 
MAX_WINDOWS% on line 1130 if you 
need more than 80 windows at once. 

DIY Toolkit's CHBASE returns the ap- 
parent base of channel details as seen by 
extension code. WINDOW_OFFSET is 
zero on a standard Qdos machine, but 
increases as windowing extensions ex- 
pand the channel table. 

If Qdos seems intact Qlipboard takes 
over cursor swapping, so you don’t have to 
keep typing Control C. FIND _MYQ and 
SET_MYQ swap queues by PEEKing and 
POKEing the system keyboard queue 
pointer, SV_KEYQ, which steps between 
the queues at the end of console channel 
definitions, after each Control C or what- 
ever. 

|need to scan characters from window O 
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and others like it, ignoring file and serial 
channels. Line 30BO sifts out channels 
with the same IO.DRIVER vector as O, 
which is always the first entry in the Qdos 
table. They use the same TRAP 3 input 
and output code as SuperBasic’s channel 
0, so it seems safe to assume that they 
define windows. 


Second 


WINDOWS skips its own default chan- 
nel, 1, soittakes a second Qlipboard task 
to scan characters from Qlipboard pages. 
SuperBasic can’t run the scanner and the 
editor simultaneously, but that seldom 
matters as you can direct lines from the 
page anywhere. In 1986 | designed Turbo's 
LINK_LOAD to run several modules of a 
program in parallel; users must compile 
each ‘thread’ separately and declare ap- 
propriate globals. 

CHAN_ID is used to find the index 
number of 1 in the Qdos table. Unless 
you've clobbered window 1 this value is 
always 1 in interpreted Basic, so RET 
2°16 will suffice. 


Highlight 


PICK_WINDOW uses the WIN% array 
entries to highlight each window in turn. 
Unless the cursor size is over-ridden DIA- 
LOGUE reads it from the channel being 
clipped, setting the scanning window 1 to 
use the same CSIZE and fonts. 

Line 1930 puts the second processor in 
the spotlight for a moment. The main chip 
twiddles its thumbs till Sinclair's 8049, or 
the Thor XVI's 6802, has played finished 
the first note. 

CURSOR_ON 1! matches Toolkit 2’s 
CURSEN; likewise CURSOR_OFF corre- 
sponds to CURDIS. PAN 0,115 and PAN 


0,116 do the same jobs for most QL and 
Thor Basics, a little more opaquely, unless 
you read QL World in February 1989. 

Control E calls SHOW_BUFFER, which 
may reserve buffer memory with ALLOCA- 
TION and DEALLOCATE. Toolkit 2 
alternatives are ALCHP and RECHP; DIY 
Toolkit Volume H has RESERVE and DIS- 
CARD. Note that ALCHP returns zero 
(ERR.OK!) if it fails to find the memory 
requested, 

It there’s enough free RAM, 
MOVE_MEMORY saves and restores the 
default QL screen (32K at 128K). You can 
do this more slowly with a loop of PEEKs 
and POKEs, or leave it out if you don’t mind 
overlapping windows. 


Editor 


As listed SHOW_BUFFER uses Turbo 
Toolkit’s EDIT$, but you could use DIY 
Toolkit's EDLINE$, or EDLIN from the 
MCS disk rom. The compiled editor lets 
you select different lines by moving the 
cursor, but this always winds back to the 
start, with CPOS%=1. The editor used by 
INPUT and EDIT is puzzled by lines con- 
taining Enter characters, so XCHANGE 
translates them into backslashes (top right 
on a QL keyboard). Thus you can spilt 
and join scanned lines, even with the rom 
editor. 

STUFF makes determined use of 
QUEUE% to enter characters; QUEUE% 
featured in December 1989's QL World 
(DIY Volume Q). You could use Turbo’'s 
TYPE_IN instead of QUEUE% to enter 
characters, but might get stuck or lose text; 
TYPE_IN is designed for short strings, and 
does not report errors. 

The peppering of calls to CHBASE and 
SYSBASE should ensure that the code 
suits all Qdos systems and windowing vari- 
ations. SYSBASE returns 163840 on most 
systems, but progams may not run on 
other machines if they assume that ad- 
dress for the system variables. Thor users 
can call SYS_VARS instead. 

The machine code source in listing two 
was assembled using HiSoft’s Devpac. 
Like all recent DIY Toolkit listings, you can 
obtain my source, to adapt it or incorporate 
it into a larger program. 

The START routine points A1 at the table 
of details at the other end of the listing, and 
calls BP. INIT, the rom vector that adds 
new functions to SuperBasic. This routine 
is at the start so it is easy to find after 
loading the code. It is not used later. 

The first big lump is fairly normal param- 
eter-handling, which creates a nine byte 
buffer on the A7 stack and passes its 
address, and a channel number, to 
SD.EXTOP. This points AO at the channel 
details and calls CHAXTOP, where things 
get interesting. 

First we exclude MEM channels, the only 
others that allow EXTOP, and check there’s 
room for a cursor at the current window 
position. Notice how the cursor check 
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processes X and Y words together. The QL 


* Q@. WORLD Diy TOOLKIT — QDOS character CLIF functions 


* Versian 1.1, Copyright 1990 Sia@on N Goodwin. rom does this, and similar tricks can add 
. : ; me four bytes to four others in one step; be- 
star eal efine,al 
mave .w $110 ,a2 BPLINIT vector ware of overflows. . 
imp (a2) Next | set up registers, ready to scan a 
: rates & Bucky emiws : ‘ 7 grid six pixels wide and nine high, in vari- 
7 : Bieta OMe eee Pee et a ous steps to reflect the CSIZE. The table 
clip _int maveg #-1,d7 Flag integer return shows the register allocation just after the 
bra.s clip param ‘ +e p 
eee een ea 40,47 Pigs aoanairemak strip background pixel has been read, at 
clip param move.w $118,a2 CA.GTLIN Vector, ensures SCANLINE. | qlipped the table from my 
' kaon ow - 4 bytes of stack space notes in Devpac. 
ne. & ad_eni the F Ci 
auba.e 41,03 Die parameter expuctes Efficient machine code uses registers as 
bne.s — bad_param much as possible. Values in registers can 
move. 1 Olal,ad.1),00 Get BASIC channel number be accessed much faster than from 
’ addq.1 #2,at teave room for one INT ’ ' t ’ 
move.l a, $58¢a8) Set maths stack BV.RIP memory, but optimum allocation is a big 
mas #40,d0 Channel table size problem, complicated by processor quirks. 
a cae ai Bd, Bese iors see This is where human programmers can 
hge.s whal chan Past end of table? excel over compilers. The scanner uses all 
semiin eee oa eer 16 68008 registers; indeed, | run out of 
a wna cnan lege 4 4 
sapees Taek ne ead a data registers and use A4 as a word data 
lea.l chaxtop,az Address of CH routine value, holding the background colour. This 
moveq #0,d3 ERR.NC if window is busy t 
lea.l -10La7),aZ7 Protect some stack space works, or lang pet bead don't want to do 
movea. 1 Ai —-> Pattern buffer start much arithmetic with the value. 
aoe 2 Sr en rar key The code to extract each pixel, around 
rap 3 all the device driver a 
lea.l 1favh,a7 Diseard patkern {this time) SCAN_ROW, can be faster than in my 
move.1 $58(a6),al Retrieve maths stack BV-RIF PIXEL% reading function, as it need not 
combine the two colour bytes; it is enough 
tset.l dh Channel error? % a IP q ‘i 
bolce: “rebucn. da No to align them with the STRIP data, which is 
move.1 dO, di Return error code in Dt also a pair of bytes. The scanner builds a 
maveq #O,d0 Disregard EXTOP error code i 
i return_val tst.1 d? Integer or string result? font pattern in the buffer addressed by 
| bmi. 5s return int (AJ ) 
return str tst.w 1 Did the lookup succeed? 
bmi.s teturrn mul Return null "" if mot 
move.b d1,Otal,aé.)) Stack character code Pattern 
subq.] #2, a1 Room for string length 
move. 1 al, $58la6) Update BV.RIP 
penne shellac +a6.1) Stack length LOOKUP is potentially another EXTOP 
ra.s got str . ' . . 
\ return nul cir.w O¢at,ad.1) Stack a null satring routine, taking a buffer pointer in Ai and 
got str muUveg #1,d4 Indicate string result returning a code in D1. It looks for the 
rts H Hl 
return int move.w d1,O0¢at,ad.1) Put result in space pattern at (A1) ma both fonts, checking all 
moves 45,44 Indicate type is INT eight bits. As soon as amis-matched line is 
ike ie rts as Seat eee cade found, it steps to the next character. This 
; at chan moveg —~&,dd CHANNE error y ‘ f ff 4 
hierar EebSS Eade ea. Gi OO saves alot of time, especially if the first line 
bad_param moveg #-15,d0 BAD PARAMETER error differs from the pattern. DESCENDERS 
pS checks the channel's flags and ignores the 
range_err moveq #-4.da Out of Range report code . li fth if UNDER 1 
rts fi.e. na room for cursor) ‘aoe aio Ineo t e€ pattern, i 
* is indicated. 
* CHAracter eXTended OFeration: AQ-> Channel, Al—> Buffer | analysed the standard rom fonts in case 
* y Lan 
chaxtop moved #40,d0 Size of a MEM block it would be faster to check lines in some 
ee fae) ate Beets Eat as eit aa less obvious order, and found that the third 
eq.s ad param I joes mot suit . . . 
nivel BReee aati ack s= XPOS & ¥POS and seventh lines in either font most often 
bmi.s range_err Reject if XPOS < a distinguish characters apart. The differ- 
i bane do ari td eae aia ence was small: out of 12,800 comparisons 
1 . tf = 1 4 4 
i mi.) gaewod aD DO i= Do) Ss & Fe for each row of 161 characters, those rows 
: emp.w  3Oad) dO Is the window too short? distinguished 90 per cent, versus 85 per 
bhi.s range_err 
swap da Move X to the lawer word cent for row 0. ‘ i 
cmp.w 28(a9),d0 Is the window too narrow? The optimisation might help measurably 
j bhi-s 9 range_err when scanning lots of small letters, but | 


find pixel move.w 34(aG).di Dt s= x . p 
add-w -24¢a0).d1 Add windes offset to. x kept the simpler code. At present pixel 


move.w  36(a0,d2 D2 z= ¥ scanning takes longer than font searching 


add.w 26(a0) ,d2 Add window offset ta ¥ j 
movea.-l SO(a0),a? Get screen RAM base address unless the character Is far down font 2, SO 
lsl.w #7.d2 i fine wees. 2°57 = ise bytes | think the balance is about right. 


adda.w = d2,aZ Get address of start of line The table labelled DEFINE indicates 


Pixel mask move.w #4$B80B0,d7 Presume MODE 4 pixel mask _ 
Btst #3, 52 (ad) Check MODE (SV.MCSTA) the names and addresses of the com 


beq-s mask ok MODE 4, no worries mands. | put this last to ease name 


— age as ee thse aca ance EVEN changes. The assembled code will still 
st suela as or 2 bi . 
| beq.s not_a_thor This must be the OL’s MODE work as long as changes are confined to 


move.w #$COCG,d7 Use the Thor 16 celour mask the end of the file. 

not_a_ thor move.b #$CO0,d7 Adjust MODE 4 mask for @ colours i j j 

mask ah movea.w #128, a5 Depth of one QDOS video line ‘ A configurable compiled Qlipboard task 
bist #444 (a0) Double height attribute? is available, with the programs and text 
begs no _taller from this month and last, and various bells 
eee ae coenne eee ee er and whistles besides. Ask for DIY Toolkit 


no_taller moveq #1,d5 . a 
Volume S - for Screen Reading. Single 
eo q 
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btst #6.666a0) 
beq-.s no_wider 
moveq #2,d5 
move. 1 di,a3 
move c W7,d2 
and.w di,da 
1lsr.w #3.d1 
add. w dt,d1 
move.w Oat dtiw).d4 
tsl-w d2,d4 
and.w d7,d4 
move. t d4,a4 


Aa_wider 


* 


* 
moveqg #9,d2 
scanline add.1 a5,a2 
move. Ww axt.di 
move q #O,dG 
maveq #5,d5 
* 


* 

scan row mOVER #7.d4 
and.w di,d4 
MOV Go di,da 
lor.w #3.d0 
add.w do,do 
move .w O(a2,d0.w) .d0@ 
Isl.w d4,d0 
and. w d7,d0 
cmp. w a4,da 
beq. 4 roll_an 
addq.w #2,a6 

ro} ian add.w dé,d6é 
add-w a5.di 
dbra d3,scan_ row 
move. b dé, (al)+ 
dbra d2,scanline 
lea.l -9(al),at 

* 


~ 

lookup moveq #O,d1 
move .b tald+.d4 
move. I 42 (aQ),aZ 
ber.5 scan fount 
beq-s result di 
move.1 44(a0) , a2 
bsr.s scan fount 
beq.s result di 
moved #-7,d1 

result di moveg #9,d0 
rts 

. 


* Entry: A2 —> Fount base, Al —- 

” 

scan fount move.b {a2)+,dGl 
moveq #O,d0 
move.b {a2)+,da 

test start cmp.b (a2)+,d4 
bne.s zoam on 
maveq #5,d2 
mover. 1 at,as 
move. 1 a2,a4 
capm.b Caf +, (asd + 
dbne d2.5can all 
beq.s descender « 
addq.! #8.a2 
addq-b Hist 
dbra dQ, test start 
moved #-7 2.40 
rts 

* 

descenders btst #0, 661a0) 
bne.s last_line 
move.b (a4) .a2 
cmp.b tas) ,a2 
bne.s zoom on 

lest _line move.b 1(a4) ,d2 
cmp.b 1(a3).d2 
bne.s zZoom_on 
rts 

* 

* Routine names and addresses 

* 

define dc.w 0,o 
dc.w 2 
dc.w elip_int—s* 
de.b 3,7 CLIPZ” 
dc.w clip_str—* 
de.b S, "CLIPS" 
dce.w Oo 


end 


* Look up the character pattern at 


* SCAN _FOUNT; corrupts DO, Di, O2, 


Double width attribute? 


Boost X step 

Preserve character X edge 

Mask bottom 3 bits of X 

D2 I= gixel # in word, 0-7 

Dit z= line byte oftset, X DIV 8S 
Address only even words 0-126 
D4.W i= background screen word 
Shift pixel data to high bits 
Mask aut a reference pixel 

Save background for later 


* Scan all nine lines and compare them with the STRIP colour in A4& 


DBRA through 9 lines 
Advance to next line 
Reset X ts left edge 
Clear fount pattern 
DBRA count for X (S-O) 


* Sean a row of six pixels. AZ ->» video RAM line, Dt is pixel X, 0-511 


Mask for bottom bits of X 

X && B@ is pixel # in ward 
Copy old X before massage 
Offset on line is X DIV B 
Address only even words G-126 
DO.W i= relevant screen ward 
Align pixel in Most Sig bits 
Mask out the background 

Does pixel match the strip? 
If yes, leave bit unset 

Set one fount bit 

Shift pattern along 

Advance ta next column 


Stuff fount line in buffer 


Retrace to start of buffer 


{Al) in both founts 


Clear high bytes of code 
Pre-read the first line 
A2 —> Fount 1 base 


Match? 


A2 —> Fount 2 base 


NOT FOUND error code 
Signal no QD0S errar 


A2, AS. A4S Exit: NZ, DI=ASCII 
Fatternt1, D4 = start of pattern 


Get first pattern # in fount 
DBRA pattern count in bytes 

DO == Number of patterns © i 
Exclude B4-88% of matches 
Ignore the rest if mismatched 
DBRA count for mare lines 

Scan pattern at (AS), saving Al 
Check versus (44) preserving AZ 


Check each line of pattern 
First 7 lines are OF... 
Skip remainder of pattern 
Acsume next ASCII code 


Not found, exit with 7 reset 


Check for UNDER 1 


UNDER ©, Check line § 


Line 9 (last in pattern?) 


So near and yet so far... 
MATCH! Exit with Z set 


No procedures 
Two functions 


End of list 
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volumes cost £7, recorded on disk or 
microdrive. Each further volume ordered at 
the same time costs £3 extra; there are 
now 14 volumes. CGH supplies disks, but 
tape users must send one formatted car- 
tridge for each volume required. Call 
Richard Alexander on (0559) 384574 or 
write to DIY Toolkit, Cwm Gwen Hail, 
Pencader, Dyfed, Cymru SA39 9HA. 


Fast 


The disk Qlipboard incorporates Phil 
Spink’s fast windowing editor, with adjust- 
able tabs, word-wrap, paging, filing and 
other civilised features. That editor was 
enhanced and tested for Quickfax more 
than a year ago. That project has stalled 
but Phil's editor deserves an airing. It has 
been carefully and intuitively designed, 
and recognises a superset of popular QL 
control keys. 


his game is a 
new adventure 
from the CGH 
stable. This rep- 
resents yet another new direc- 
tion in adventures, being set 
inside the very computer you 
are using. The manual (as 
usual) is short and gives just a 
little insight into the game, be- 
fore you enter your first 
location. 

Assoonas you load the game, 
some of the differences in this 
adventure will become appar- 
ent. The screen is divided into 
four, with the name of the cur- 
rent location at the top of the 
screen, below which appears a 
description of the location. At 
the bottom of the screen is a 
graphical representation of the 
current exits, and another win- 
dow where you enter your 
commands. The method of en- 
try of commands is distinctive 
in that the parser will only al- 
low you to type words which it 
recognises. It does this by 
checking every letter as it as 
typed, and if the given letter 
does not fall into a recognised 
word, a beep is issued and the 
letter is not shown on screen. 
This may speed up checking of 
the commands, and also pre- 
vents any ‘not understood’ 
errors. However, the method 
of deleting letters is rather 
cumbersome in that instead of 
the previous letter being de- 
leted, a back arrow is printed 
onscreen. This can lead to con- 
fusion, but thankfully pressing 
ESC abandons the command. 

One soon becomes used to 
the new method of entry of 
commands, and with the pro- 
gram’s ability to understand 
multiple commands, one soon 
begins to zip around the loca- 
tions. Movement can be done 
by the normal east, west, north, 
sound commands, or simply 


by using the cursor keys if pre- 
ferred. I must admit that | 
would have preferred a normal 
means of command entry, es- 
pecially when you begin and 
are unsure which commands 
the computer will understand. 

This first location actually 
presents the first major prob- 
lem. You are outside the 
computer which is not work- 
ing, and need to get inside it to 
fix it. Without a screwdriver or 
manual to hand, you soon dis- 
cover that there is no easy 
method of entry; more ‘direct’ 
methods must be used. Once 
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Rich Mellor gets inside the last word in adventure, 
where the compiler is a black and white cat 


inside the computer, you will 
find some text telling you that 
the computer is in a right state 
with lots of unfinished tasks 
and half-written routines. As 
you go around, you will dis- 
cover just what these tasks are. 

Unfortunately at first ap- 
pearances there do not seem to 
be very many locations, and 
even fewer objects. Looking 
around you will find lots of 
different characters which 
make up the different parts of 
the computer, ranging from 
compilers to viruses. Each of 
these has a different function, 


and while some will be able to 
help you, others are there to 
hinder you (or even kill you). 

The compiler (a black and 
white cat) is a great help dur- 
ing the early part of the game, 
although presenting him with | 
something to compile makes 
him ask you a cryptic question 
which must be answered to get 
anything useful for him. An- 
swering some of these 
questions will open new areas 
of the computer up for you to 
search, while others will pro- 
vide you with the means to 
finish tasks. A sign near the 
entry point to the computer 
tells how well you are doing by 
presenting a reading of a fail- 
ure rate. | have only achieved 
an 82% failure rate so far in 
several hours of play and so I 
have a long way to go yet! 

Many of the different tasks 
involve plays on words to give 
you a hint as to what is needed 
(there is no help feature in this 
adventure), For instance, the 
stack is missing its pointer - do 
not try looking for a computer- 
type pointer! 

The puzzles within the game 
are very well thought out and 
involve a logical means of 
solving them. It providesa little 
insight into the workings of a 
computer as well as being an 
entertaining game. Fortunately 
there is no need to have an in- 
depth knowledge of 
computers, although a Roget's 
Thesaurus can be a big help. 
Thankfully the game can be 
saved ontoany device to return 
to ata later date, since I can see 
that a pen and paper may be 
just as useful as a computer 
keyboard. Despite one or two 
minor criticisms about the 
method of command entry, | 
must say that the program is 
well worth getting one’s teeth 
into. 
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PRODUCT 
REVIEW 


ome people in the computer mar- 

ket must by psychic. Just as my 

trusty Sandy keyboard was be- 
ginning to show signs of its vener- 

able age the postman brings a saviour to 
the rescue — a new piece of electronic 
wizardry from Jeurgen Falkenberg. 
Falkenberg, you will remember, was re- 
sponsible for the excellent scanner re- 
viewed in QL World some months ago. 
His latest offering is not a keyboard, but a 
chip-laden link to a standard PC-style 
keyboard, which gives users a choice of 
the full range of PC keyboards available in 
the UK today at very reasonable prices. 
The original QL keyboard came in for a 
lot of criticism early in its life. One journal- 
ist wrote “Hands up all those who like the 
new QL keyboard . . . what a lot of funny- 
looking hands”. Designed to be cheap to 
make and better to use than the Spec- 
trum’s rubber keys (and, incidentally, much 
better than the awful keyboard of the IBM 
PC jr.), the QL keyboard was still not as 
good as a “grown-up” PC keyboard. | 
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touch-typed my way through the manu- 
script of my first book using nothing but a 
QL keyboard, and | know of other authors 
who did the same, but many good typists 
could not get used to its tacky feel. 


Smart money 


One solution was to replace the top of 
the QL with one possessing better-sprung 
keys, and this proved to be a much more 
acceptable improvement than might have 
been thought. Nevertheless, the smart 
money went on add-on keyboards which 
were linked to the QL via a cable and 
which had a separate numeric keypad 
and additional keys laid out in PC XT 
style. As the owner of one of the original 
Sandy keyboards | can vouch for its ease 
ofuse and considerable endurance. Giving 
a journalist a keyboard is rather like giving 
a six-inch nail to a sixteen-stone carpen- 
ter—it tends to get thoroughly hammered. 

Recently, as | remarked earlier, the 
Sandy keyboard began to show signs of 
senility. It would forget some of the 
keypresses, and occasionally had astroke 
which would paralyse one side completely. 
The ribbon cable which lay across my 
desk like the Channel Tunnel rail link 
across Kent would snag papers and books 
so that a slight movement of the keyboard 
would partially dislodge it, rendering many 
of the keys useless until the socket had 
been pushed back into place. Keyboard 
bounce — the QL’s annoying habit of 
printing random letters twice — was not 
eradicated by the Sandy keyboard, al- 
though it appeared to be reduced. All of 
these weaknesses could be lived with, but 
the keys in the centre of the board were 
beginning to wear out so that a delicate 
press was ignored and only a table- 
shaking stab would produce a response. 
After four years of unrelenting toil, it was 
time to find a new keyboard. 


Letterbox 


With impeccable timing, Jeurgen 
Falkenberg’s gizmo was thrust through 
my letterbox. Mounted on a card some 
12cm by 6cm, a cluster of eleven silicon 
chips gave some clue as to the computing 
power required to accept input from a PC 
keyboard and translate it so that it was 
fully compatible with what the QL expects. 
At one end of the keyboard a short cable 
was mounted, ending ina DIN plug familiar 
to anyone who has examined the back of 
a PC, or a QL for that matter. At the other 
end of the small card was an empty 
mounting slot. Unfortunately, the Jiffy bag 
contained nothing else — no fitting instruc- 
tions, no user guide, and no invitation for 
a week's expenses-paid holiday in the 
Rhine valley. 

The purpose of the card was obvious 
enough — but what about fitting it? The 
QL's keyboard is managed by an interest- 
ing little chip called the Intel 8049. It was 
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perhaps the first “computer on a chip”, in 
that it has its own arithmetic logic unit 
(alu), central processing unit (cpu), aread- 
only memory (rom), and a tiny amount of 
access memory (ram) all built on the 
same wafer of silicon. For a chip so com- 
prehensively equipped, it is a little disap- 
pointing to find that it is not very bright. In 
the QL its task is to relieve the M68008 
cpu from much of the mundane work of 
listening out for keypresses and control- 
ling microdrive and diskdrive activity. The 
empty mounting slot on the keyboard con- 
trolling card was exactly the size for an 
Intel 8049, and small cutouts in the card 
fitted exactly with the topology of that part 
of the QL’s motherboard where the Intel 
8049 is situated — towards the front left, 
immediately beside the microdrive 
housings. 

With only alittle trepidation | opened the 
QL’s case, carefully avoiding dislodging 
the wires which supply current to the vari- 
ous leds on the computer's top. The rib- 
bon cable to the Sandy keyboard was 
quickly removed and, using a plastic chip- 
removing tool and alot of patience, sowas 
the Intel 8049. | pressed the chip into its 
new home on the piggy-back card and 
then began the process of gently per- 
suading the pins underneath the card to 
slotinto the holes left by the Intel chip. The 
secretis to slowly increase pressure across 
the entire width of the mounting so that 
pins do not become bent. It is surprising 
how much weight is actually required to 
press home the pins. 

The final problem was how to get the 
cable out of the QL case so that a key- 
board could be plugged into it. After seri- 
ously considering the removal of the sec- 
ond serial socket for a few moments | 
finally decided to unplug the expansion 
card, thread the cable through the huge 
hole in the QL’s left side and then slot the 
expansion card back in place 

Some days later | received a call from 
Falkenberg’s UK agents to say that the 
QL-Keyboard-90 card was also available 
in a form which simply plugs into the QL's 
rom port. This is amuch simpler method of 
upgrading the QL and one which is rec- 
ommended to anyone frightened of taking 
a screwdriver to his or her beloved com- 
puter. 


Simpler method 


The rest was easy: simply rob a passing 
PC of its keyboard and pug its DIN plug 
into the waiting socket. Nevertheless, 
powering up the QL was a little nerve- 
wracking. What if this wasn't a keyboard 
controller after all, but some other arcane 
device which | had completely 
misidenified? All was well, though. The 
keyboard lights flickered, the QL booted 
normally and | began typing away. 

It was quite unusual to find myself using 
a QL with a fully-functioning PC keyboard. 
Deleting was performed not by the Ctrl- 
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left arrow key combination but by the PC’s 
backspace key. Similarly, the PC’s delight 
key performed the action normally ac- 
complished by pressing Ctrl-right arrow. 
The function keys, numeric keypad and 
cursor keys worked exactly as would be 
expected. Rather surprisingly, so did the 
Escape key: it acts like Ctrl-Space to halt 
a SuperBasic program or exita line-editing 
sequence. Within a few moments the feel 
of the new Keyboard lost its alien nature 
and | quickly adjusted to the new key 
positions. 


Free to choose 


QL-Keyboard-90 is for sale in the UK at 
£75, which includes VAT, and it is avail- 
able from TK Computerware in Kent. At 
the price it is not cheap, and many users 
without their own PCs will have to consider 
buying a keyboard as well, so can it com- 
pete in the keyboard add-on stakes? 

The answer must be a definite yes. The 
keyboard mapping vastly exceeds in 
power and ease of use anything previously 
offered on the QL market. By buying 
Falkenberg's card you are then free to 
choose any of the myraid of PC keyboards 
available through mail order in Computer 
Shopper and other similar magazines. 
Good PC keyboards start at around £50, 
although some de luxe models can cost 
nearer £100. For many users, though, it 
will be a case of borrowing a keyboard 
from a PC, or maybe buying a second- 
hand keyboard attached to a broken PC, 
reducing the costs. Two simple jumpers 
on the card allow the firmware to be 
configured for old or new styles of XT and 
AT keyboards. 

With full documentation and in its final 
release version, QL-Keyboard-90 has the 
feel of a quality product and it will undoubt- 
edly improve your typing. Running Digital 
Precision’s excellent PC-Conqueror 
emulator couldn’t be easier if you are 
using a real PC keyboard. People with a 
desk cluttered by too many keyboards 
can now make one keyboard do the work 
of two. All in all, QL-Keyboard-90 is a 
complex product which does a very good 
job without bothering the user and if it suits 
your circumstances, and your pocket, | 
recommend that you give it serious 
thought. 
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sidered symbolic constants, 

variables, sequence control 
and conditional statements. 
There is another conditional 
statement (the switch state- 
ment) that we will look at in a 
future article. 

The two main topics this 
month are handling arrays and 
basic file processing. There are 
three program listings included 
to illustrate the new concepts. 
A few other new ideas are also 
mentioned in passing. 

Listing one illustrates very 
simple array processing. It 
takes input from the keyboard 
and counts the number of times 
that each of the different keys 
is pressed. When you press 
the ESC key it displays the 
results. 

The program begins by de- 
fining afew symbolic constants. 
SIZE_ASCII represents the 
highest character code value 
used in the QL character set — 
all character codes are in the 
range zero through 255. 
NUM_LINES represents the 
number of lines of data that can 
conveniently be displayed in 
the window in which Digital C 
programs run. 

Digital C supports intand char 
data types. You can also de- 
clare arrays of integers and 
characters. The syntax is: 


‘ nthe last instalment we con- 


data_type variable _name 
[array_size]; 


The array_size must be en- 
closed within square brackets. 
The number of elements in the 
array is one more than the 
array_size. In our program the 
array contains 256 elements 
(SIZE_ASCIlI + 1). 

Arrays in C are similar to 
arrays in SuperBasic, but there 
are a few differences. As they 
say, variety is the spice of life. 

Each element of the array is 
referenced by specifying a 
subscript enclosed in square 
brackets (SuperBasic uses 
round brackets). For example, 
the first element in the array is 
referenced as variable_name 
{0], the second= as 
variable_name [1] etc. 

The program in listing one 


declares an int array named 
num_char. This array consists 
of 256 elements numbered from 
[0] through to [255] 
(SIZE _ASCllis 255). Each ele- 
ment of the array can hold an 
int value. The array is used to 
represent the 256 possible Ascii 
characters. 

After printing a few lines of 
introductory text the program 
executes a for loop. At the be- 
ginning of the loop the value of 
sub is set to zero. The loop 
keeps repeating so long as sub 
is less than or equal to the 
highest subscript value in the 
num_char array (255). At the 
end of each pass through the 
loop the value of sub is 
incremented by one. 

The body of the loop consists 
of asingle statement which sets 
the value of num_char [sub] to 
zero. If the elements in the ar- 
ray were not initialised to zero 
they would contain garbage 
values. 


Andy Wright 
continues his 
beginners’ guide 
to C with arrays 
and file 
processing. 


An experienced C coder 
might have coded the for loop 
that initialises the array as: 


for ( sub = 0; 
sub <= SIZE_ASCIl; 
num_char [sub++] = 0 ) 


s 


In this new version the body 
of the for loop includes no 
statements — the single semi- 
colon at the end indicates this. 
At the end of each repetition of 
this non-existent body of state- 
ments, the following is ex- 
ecuted: 


num_char [sub++] = 0 


The position of the ++ symbol 
is important. It tells the system 
to set num_char [sub] to zero 
and then increment the value 
of sub (ie it uses the current 
value of sub and then incre- 
ments it). 

Num_char [++sub] = 0 would 
have incremented sub first and 
thensetnum_char [sub] to zero. 

The new version of the for 
loop is more concise and, inthe 


eyes of some, more elegant. 
Such shorthand techniques are 
common in C programs. Peo- 
ple who are new to C some- 
times find it confusing. People 
who are experienced C pro- 
grammers occasionally take 
satisfaction in how simple it is 
when you get the hang of it but 
how confusing it all can be to 
the uninitiated. 

The next part of the program 
uses a while loop to process 
the next key typed in at the 
keyboard. The Ascii code of 
the key is stored in the variable 
inp_char. 

The loop stops when the 
(ESC) key is pressed. Each 
pass round the body of the 
while loop adds one on (using 
the ++ operator) to the 
num_char array elementwhose 
element number is the same 
as the value of inp_char. So, if 
you press A the value of 
num_char [65] is incremented 
by one — the Ascii code for an 
upper case A is 65. The state- 
ment: 


++num_char [inp_char]; 


illustrates that char variables 
can be used as integers since 
they actually contain integer 
Ascii character codes. 

The use of the putchar func- 
tion within the loop makes sure 
that the character that you type 
is also displayed onthe screen. 

The last part of the program 


r 


Array declared as: 


char inp_val[9] : 


ARRAY CONTENTS 


EQUIVALENT 
STRING 


inp_valfO] inp) val{t] 


f 
é 


| (flalelolwo[?!2 


= 
end of string 


\ 
\ 


\ 


/ 


eg 


hola ela|Arjrle 


be 


E | | H N| | s| mi | T [ro | 


"FRED" 


| " (empty - no value) 


| "JOHN SMIT* 


Fig 1: Character arrays and strings 
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uses a for loop to print out the 
values held in the array. Ini- 
tially the variables sub and 
count are set to zero. The vari- 
able sub represents each ele- 
ment number in the array — 
corresponding to the Ascii 
characters 0 through 255. The 
count variable is used to keep 
track of how many lines have 
been printed on the screen. 
The loop keeps going while 
sub <= SIZE ASCII — ie until 
all of the elements in the array 
have been processed. At the 
end of each pass round the 
loop, both sub and count are 
incremented. 

The printf function prints two 
versions of sub. One is a deci- 
mal version of the Ascii charac- 
ter code (using the %3d for- 
mat), the other is the QL char- 
acter which has the corre- 


sponding Ascii code (using 
the%c format). On each pass 
round the loop sub represents 
and Ascii character. The value 
of num_char [sub] represents 
the number of times that the 
corresponding keyboard char- 
acter was typed. This is printed 
as a decimal (%5d) value. 
Whenever the value of count 
is greater than NUM_LINES 
you will be prompted to press a 
key. This stops the display 
scrolling off the screen before 
you can read it. If you press the 
ESC key, a break statement is 
executed. This breaks (jumps) 
out of the loop that you are in — 
even though the condition de- 
fined in the for statement is still 
true. Program control passes 
to the statement at the end of 
the loop ( the printf function in 
our program). Similar facilities 
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are provided for getting out of 
loops in SuperBasic. If you 
press anything other than ESC 
the value of count is reset to 
zero and the for loop carries on 
with the processing. 

Right at the end of the pro- 
gram, getchar is used to make 
sure that the display remains 
on the screen until a key is 
pressed. Note that the value 
returned by getchar is thrown 
away or discarded since no 
variable name has been speci- 
fied to hold the value. 


Exercise One 


1. Change the program so 
that the array elements are not 
initialised to zero and run it a 
few times. 

2. What would happen if you 
tried to update num_char [256] 


#define SIZE ASCII 255 


#define ESC 27 


#define NUM_LINES 10 


main ( ) 
< 
int 
Bub, 
count; 


printf ¢«" 
for ( Bub = 


++aub 


while ( 
sf 


t 

for ¢ 
Bub <= 
++Bpub, 


{ 


if 


} 
} 


getchar(); 


num char[SIZE ASCII], 


(inp_ 


Bub = count 


printf("%3a 
Lf (¢ Gount > NUM_LINES ) 


char inp char; 


O; 


Bub <= SIZE ASCII; 


} 


num_charfsubj] = O; 


char = getchar() ) 


+tnum_charf{inp_char}]; 
putchar(inp char); 


= F 
SIZE ASCII; 
++count } 


<&O> 


printf("\nPresa a key to continue 
inp_char = getchar(); 


(inp_char == ESC ) 
break; 


count = O; 


Listing 1 


/* An array of integers 


i= ESC j 


*5d\n",sub,sub,num_char[sub}); 


(ESC) 


printf<¢"\nPresas a key to finish"); 
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until you presa 


to stop\n\n\n\n"); 


— or any other element be- 
yond number 255? If you try 
this it.will have unpredictable 
and potentially nasty results 
since it will update bits of the 
computer's memory which lie 
somewhere beyond the end of 
the array. Accessing non-ex- 
istent elements in an array isa 
sure-fire (and fairly straightfor- 
ward) way of guaranteeing that 
your program produces gar- 
bage — or worse. 

3. Try using the alternative 
for loop for initialising the array 
elements. Code it correctly and 
then try coding it incorrectly 
(putting the ++ operator in the 
wrong position). 

4. Re-write the loop that dis- 
plays the results so that it 
doesn't print anything at all for 
array elements with a value of 
zero — ie those representing 


Printf ("Thie counts the number of occurrences of each ASCII\n"); 
character that you type, 


(ESC) \n\n"); 


‘ 
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keys that were pressed zero 
times. 

5. You should find that the 
display is messy for the char- 
acter whose Ascii code is 10 
(the ENTER or newline key). 
This is because printing the 
character (%c) version forces 
the screen display to do a 
linefeed. Try to stop this from 
happening. You will need to 
include an if statement to 
change what happens when 
sub is equal to 10. 

6. What would happen if the 
same key was pressed more 
than 32767? Change the code 
so that this cannot happen. 

7. Try printing the value of 
num_char without specifying an 
element number. 


Listing two illustrates the use 
of a character array in C. The 
use of the #include compiler 
directive and a few new stand- 
ard library functions are also 
considered. 

The program itself inputs two 
numbers and calculates the 
result of multiplying them to- 
gether. The results are dis- 
played on the screen. 

The program in listing two 
starts off with a #include com- 
piler directive. The basic syn- 
tax is: 


#include file_name 


The C pre-compiler reads the 
contents of the file named in 
the #include directive and in- 
cludes it in your program in 
place of the #include directive. 
The file fip1_stdio_h that is 
used in our program is sup- 
plied with the Digital C com- 
piler. Most of it is made up of 
some standard defines. Some 
of the coding in listing one de- 
pends on the #defines of 
stdio_h being included in the 
program. 

Using #include can save alot 
of repetitive coding. Just code 
the stuff in a single file and use 
#include to copy it into any pro- 
gram that you like. Just about 
all C compilers are provided 
with an stdio_h file although on 
non-QL computers it is usually 
called stdio.h and to include it 
you would use: 


#include <stdio.h> 
/* including stdio.h on a non- 
QL system */ 


Note that with Digital C the 
file_name must include the 
device name (fep1_ is used in 


our program; if you are using 
microdrives then use mdv1_ or 
mdv2_). On many other imple- 
mentations of C the device 
name (or its equivalent) is not 
needed if you enclose the name 
between < and > symbols. 

The program defines two 
arrays of characters — each 
with seven elements — num- 
bered from zero to INP_SIZE. 

In C allstrings are made up of 
arrays of characters. This is 
also true of SuperBasic. How- 
ever, it is often possible to ig- 
nore this fact when writing pro- 
grams in Basic— youcan never 
really afford to forget it when 
using C. 

One area where C character 
arrays (or strings) are signifi- 
cantly different from 
SuperBasic is that in C the end 
ofastringis always represented 
by a character with the Ascii 
code zero. The Ascii character 
with the code zero is repre- 
sented, in programs, as \0. This 
means that a character array of 
10 elements (numbered from 
zero to 9) could contain a string 
of 0 to 9 characters and still 
have room for the \0 string ter- 
minator. 

Even when you type inastring 
of characters enclosed in quo- 
tation marks, C treats it as an 
array of characters and puts in 
a \0 terminator for you. Figure 
one illustrates this. 

Meanwhile, back at listing 
two, note that the condition 
used in the while loop is always 
true since the expression (1) is 
always non-zero. This means 
that the loop will keep on going 
until it is stopped by a break 
statement. 

The for loop is nested within 
the while loop. It reads charac- 
ters from the keyboard and 
stores them in the character 
array (string) inp_string_1. The 
integer str_pos is used to refer- 
ence each of the elements of 
the inp_string_1 array in turn. 
At the beginning of the for loop 
str_pos is set to 0 — to refer- 
ence the first element. The 
condition associated with the 
loop uses getchar to store the 
keyboard key into the variable 
inp_char. Ifinp_charis the Ascii 
code for the (ENTER) key then 
the loop is terminated. The \n 
used in the program is equiva- 
lent to the Ascii code produced 
by the QL (ENTER) key. 

If inp_char is a non-digit then 
itis ignored. Otherwise, the digit 
is stored in the string array and 
the value of str_pos is 


incremented. If the array has 
only one unused element left 
(ie the value of str_pos is equal 
to the array_size) the break 
statement is used — this termi- 
nates the for loop immediately. 
If this check on the value of 
str_pos was not included then 
you would be able to type ina 
potentially unlimited number of 
numeric digits. As str_pos went 
beyond the end of the memory 
allocated to the array, the con- 
tents of other areas in the ma- 
chines memory would get cor- 
rupted. Notice that if str_pos 
equals INP_SIZE the final ar- 
ray element has not been used 
— the last element is needed 
so that we can store the C 
string terminator (\O) at the end 
of the array. 

At the end of the for loop the 
value of str_pos is checked. If it 
is zero then no digits were typed 
in. The break statement then 
terminates the while loop and 
the program ends. 

Ifsome characters were typed 
into the array then an extra 
character \Ois added to the end 
ofthe array. Inthis case str_pos 
points to the array element af- 
ter the last one that was en- 
tered. All C standard functions 
recognise the end of a string of 
characters by the existence of 
this terminator. 

Because of the way that we 
have built up the array of char- 
acters (using getchar) you 
should find that you cannot 
change any of the characters 
that you type in. As it is written 
the for loop will simply ignore 
you if you use the CTRL key or 
any of the arrow keys. But at 
least all of the alphabetic keys 
etc are ignored as well. 

The value of inp_string_2 is 
picked up using the fgets C 
library function. Another for loop 
could have been used, but the 
program has gone for versatil- 
ity rather than consistency. (In 
most real-life programs it is 
usually safer to stick with con- 
sistency!) The syntax of fgets 
is: 


fgets ( character_array_name, 
number_of_characters, 
file_descriptor ) ; 


In fact the character _ array 
_name is really a pointer to a 
character string. We will cover 
pointers in detail in a future 
article. 

The characters that are typed 
in are automatically stored in 
the named array. Input is auto- 


matically terminated either 
when the you press ENTER or 
(number_of_characters - 1) 
keys have been pressed. You 
should find that the way that 
fgets works on the QL allows 
you to make changes to the 
string that you type using the 
arrow and CTRL keys. What- 
ever you type is also automati- 
cally displayed on the compu- 
ter screen without you having 
to use putchar. 

The fgets function can read 
from any open device or file. 
This means that you must tell it 
where to read data from. The 
device is specified using a thing 
called a file_descriptor — 
somethimes known as a file 
pointer. In listing two the file 
_descripter stdin is used. A 
file_descriptor is a bit like a 
channel number in SuperBasic. 
InC stdin refers to the standard 
input device. By default this is 
the keyboard. The stdin device 
is automatically opened ready 
for use when acompiled C pro- 
gram is run. 

We have already used one 
function that always reads from 
stdin (the getchar function). 
Because getchar can only ever 
read from stdin you don't tell it 
which file to read from. With 
fgets you have to specify a 
file_descriptor, otherwise it 
doesn't know where to read its 
data from. In our program the 
descriptor stdin is used in the 
fgets function. When stdin is 
mentioned explicitly in a pro- 
gram, its value must be de- 
fined. The #included file stdio_h 
includes a definition for stdin 
so we don’tneed to worry about 
it. 

One curious aspect of fgets 
is that if you press ENTER to 
terminate the input then the \n 
(newline) character is included 
at the end of the array of char- 
acters that you type. If 
(number_of_characters-1) are 
typed in and fgets stops all by 
itself, then no \n is added to 
them. 

The standard string termina- 
tor \0 is automatically added to 
the array — just after the \n or 
the last character that you 
typed. This means that if you 
type 123 (ENTER) the array 
contains: 


123\n\0 
If you type 12345 (ie INP_SIZE 


- 1 characters) the array con- 
tains: 
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Aaa aka te oe 


12345\0 


There is nothing in the fgets 
function to stop you typing non- 
numeric characters. These will 
just be included inside the ar- 
ray. 


The printf statement at the 
end of listing two prints the in- 
put strings. Both inp_string_1 
and inp_string 2 are printed 
using the %s format specifica- 
tion. %s is used to print charac- 
ter arrays (strings). It starts at 
the beginning of the array and 
stops when it gets to the string 
terminator \0. 

The %6d format specifica- 
tion is used to print the result of 
the expression: 
ato! (ino_string 1 * atoi 
| (inp_string_2) 


The atoi funtion converts a \0 
terminated string of Ascii char- 
acters into an integer. The con- 
version stops when any non- 
numeric character is found 
within the string (for example a 
\O string terminator or a \n 
newline character). This would 
mean that if you typed 12a4 the 
integer calculated by atoi would 
be 12. If you typed a3 then atoi 
would return a value of zero! 

Note that the * included be- 
tween the quotes in the printf 
statement is printed as an as- 
terisk. The * in the list of ex- 
pressions that are to be printed 
performs the multiplication of 
the integer version of each of 
the input strings. The result of 
this is printed using a %6d for- 
mat specification. 

After the results have been 


#define INP_SIZE 6 
#include flpi_stdio_ih 


main ( 3} 


{ 


char inp_string I1[INP_SIZE}, 
inp_string 2[INP_SIZE], 


/* Two arrayea 
inp char; 
str pos; 


int 


{ 


for {¢ 


while ¢ 1 ) 
/* Thies condition is alwaya true */ 


printt¢™"\nduet Press 
printf¢"\nEnter leat number : 
Btr pos = QO; 
(inp_char=getchar({)) 
/* 


(strings) 


(ENTER) 


No actions on each repetition 
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printed, the end of the while 
loop is reached and you should 
be prompted to enter another 
number. 


Exercise two 


1. Change the program so 
that no \0 is added to the end of 
the character array at the end 
of the for loop. See what differ- 
ence this makes to the way that 
the program works. 

2. Check to see if fgets and 
atoi cope with negative num- 
bers. 

3. What happens if you type 
in numbers that are too large? 
Can you change the code eas- 
ily to stop this from happening? 

4. You should find that the 
display of inp_string_2 pro- 
duced by the printf function is 
not always consistent. It de- 


pends on whether or not the 
fgets function added a \n char- 
acter to it. Change the code so 
that any \n is replaced by a \0 | 
before the value ofinp_string_2 
is printed. 

5. Try to re-write the state- 
ments: 


inp_string [str_pos] =inp_char; 
++Str_pos; 


as a single statement which 
achieves the same overall ef- 
fect. 

6. Try to replace the bits of 
the printf statement that prints 
the value of inp_string_1 by a 
for loop that uses the putchar 
function to print the contents of 
the inp string _1 array — it 
should stop as soon as it gets 
to the \0 character. 

What would happen if you 


wf 


of characters 


te qult*} 


“oF? 


L= 


eh 2 td Fy 


wf 


) 


if ¢ 
{ 


is@digit{inp char) } 


inp_string i[fetr pos)]=-inp char; 
++atr_ pos; 

putchnar(inp char); 

j if (etr_poe INP_SIZE )} 
break; 


} 


J 
Le 


(etr_pos 7/* No characters entered *«/ 
break; 
inmp_asatring l[str_ pos] = 
putchar(’\n’*'); [ 
printf£¢"\nEnter 2nd number : "); 
fgeta(inp_string 2, INP_SIZE , stdin); 
printf( "\n\nSe * a = %6d\n\n\n", 
inp_string_1, 
inp_etring_ 2, 


atoi(inp_string 1) 


"\O’; /* String terminator */ 


* atoi¢inp string 2) }+F 


| Listing 2 


Sinclair/QL World February 1991 39 


PROGRAMMING IN C 


forgot to make it stop at the end 
of the string (if you try it out you 
will have to reset your QL be- 
fore carrying on — unless you 
can kill off the program some- 
how — you have been warned. 

7.What happens if you forget 
to include the stdin file 
descriptor in the fgets function? 


Listing three illustrates how 
you can process data from files 
other than the standard input 
and output devices. 

The program given in listing 
three prompts you to supply a 
file name and then tries to dis- 
play the contents of the named 
file on the screen. 

The first few lines of the pro- 
gram are made up of #include 
and#define compiler directives. 

MAX_FILE_NAME is defined 
to be big enough to hold the 
largest sized file name avail- 
able on the QL (in fact it is 
slightly larger than necessary). 
LINES PER_PAGE is the 
number of lines from the input 
file that are displayed ata time. 
CHARS_PER_LINE is the 
number of characters that fit on 
a line inside the window that 
Digital C programs usually run 
in. 

The other symbolic constant 
that is defined is FILE — it is 
given the value int. Its use is 
described below. 

As we have already seen, 
filesin C are accessed by using 
file descriptors. These file 
descriptors are a bit like 
SuperBasic channel numbers. 
\n fact, file descriptors are used 
toaccess files anddevices such 
as the keyboard or windows on 
the screen. So are SuperBasic 
channels. 

Before a file or device can be 
accessed in C, it must be 
opened and linked to a file 
descriptor. Like other imple- 
mentations of C, Digital C pro- 
vides some devices that are 
automatically opened and 
linked to file descriptors. The 
file descriptors for the devices 
that are opened automatically 
are defined for you inside 
stdio_h. 

They are: 


stdin 
stdout 
stderr 


By convention, stdin is linked 
to the keyboard whilst stdout 
and stderr are linked to the 
screen. Stderr is usually used 
to display error messages. 
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Digital C is rather curious in 
that all three of the default file 
descriptors are linked to a sin- 
gle ODOS channel. This chan- 
nel is a console. You can read 
from aconsole (it picks up data 
from the keyboard) and write to 
a console. (the ouput appears 
in a window on the screen). 
This means that you can get 
away with writing programs that 
read from stdout and write to 
stdin. Even though you can get 
away with doing this — you 
should try to overcome the 
temptation. Attempting to read 
from an output device just 
seems wrong! 

A few of the standard C li- 
brary functions that we have 
used have written to the default 
devices. For example, getchar 
reads a character from stdin, 
while printf writes to stdout. 

In listing two we saw that the 
fgets function can read from 
any file. The cost of this extra 
versatility in fgets is that you 
have to tell it which file or de- 
vice to read from. We forced it 
to read from stdin. 

The program in listing three 
defines its own file descriptor 
and uses it to read data from a 
file on a disc or microdrive. 

The first line of the main func- 
tion declares the file descriptor. 

It uses: 


FILE * file_d; 


The word FILE is a symbolic 
constant — defined as int, so 
the declaration of the file 
descriptor could have been 
written as: 


int * file_d; 


so why wasn't it? 

Most implementations of C 
define a FILE data type. Digital 
C doesn't. In most C imple- 
mentations there would be no 
need to define FILE as a sym- 
bolic constant because it is al- 
ready defined for you. 

In Digital C you could edit 
your own stdio_h file to include 
the definition of FILE as int — 
then you wouldn't have to de- 
fine it within the program. Just 
include stdio_h. This would 
make the whole program look 
more like aC program as coded 
on, say, a computer running 
Unix or MS-DOS. 
In Digital C, file descriptors 
should be of data type int, but 
this isn’t necessarily true of 
other systems. Using the data 
type FILE gets round this prob- 


lem fairly neatly because it can 
be defined differently in stdio_h 
on different machines and it 
doesn't affect your program 
code. 

If the last few paragraphs 
bother you, it doesn’t much 
matter if they don’t make agreat 
deal of sense if you are only 
interested in using C on a QL 
with the Digital C compiler. If 
you are keen on writing C pro- 
grams that can easily be com- 
piled and run correctly on other 
computers using different C 
compilers then it is important to 
see the significance of what 
has been said! 

The other outstanding pointit 
— why is there an asterisk (*) in 
front of the file descriptor name 
file _d? One answer to this 
question is that there has to be 
an asterisk in front of it! File 
descriptors are, in reality, 
pointers to things. This means 
that the file descriptor points to 
something that tells the system 
where a file is. File descriptors 
are also known as file pointers. 
When any kind of pointer is 
declared in a C program its 
name must be preceded by an 
asterisk. We will look at point- 
ers in a lot more detail in a 
future article. For the time be- 
ing just include the asterisk. 

After the file descriptor dec- 
laration, a few integers and a 
character array are declared. 
The character array is used to 
hold the name of the file that is 
to be processed by the pro- 
gram. The array is declared to 
be at least large enough to hold 
the longest file name that you 
would find on a QL. 

A while loop is used get the 
file name. Just before the while 
loop is entered, the file_d 
descriptor is set to NULL. The 
symbolic constant NULL is de- 
fined in stdio_h (in Digital C it 
has the value of -32768, on 
other systems it may be differ- 
ent but it doesn’t matter!) 

So long as the value of file_d 
is equal to NULL the while loop 
keeps repeating and you keep 
getting asked to enter a file 
name. We shall see what is so 
special about NULL in a few 
moments. 

Note that the message that 
tells you to enter a file name is 
produced using the fprintffunc- 
tion. This is like printf except it 
can write to any open file or 
device. In listing three the mes- 
sage is sent to the stdout de- 
vice. By default this is the com- 
puter screen. 


The fgets function is used to 
read the filename from stdin. 
Immediately after the fgets 
function there is a check to see 
if any characters were entered. 
Just to be different, the strcmp 
function is used. Its basic for- 
mat is: 


streomp ( 
character_array_name or 
characters in quotes, 


character_array_name or 
characters in quotes }; 


The parameters (or argu- 
ments) to strcmp are really 
pointers to strings. Character 
array names and strings of 
characters enclosed inside 
quotes are actually pointers to 
strings — but more on pointers 
later. 

The strcmp function com- 
pares the strings and /or char- 
acter arrays. If they are equal 
to each other it returns a value 
of zero. See the Digital C docu- 
mentation for other possibili- 
ties. 

The if statement uses strcmp 
to compare the inp_name 
character array with the string 
\n. Remember that if you just 
press ENTER without typing 
any characters then fgets will 
insert the characters \n\0 into 
the character array. Ifthe result 
of the strcmp is zero then the 
exit function is used. The exit 
function terminates the pro- 
gram and closes any openfiles. 

The strcmp part of the pro- 
gram could have been coded 
as: 


/* assuming inp_val has been 
declared as an int */ 
int_val = strcmp ( inp_name, 
“\n”); 
if { int_val == 0) 

exit () ; 


The method used in listing 
three is more compact since it 
doesn't need to make use of 
the variable int_val. 

Yet another way would have | 
been to adapt the approach 
used in listing two: 


if (inp_name [0] == ‘\n' ) 
exit () ; 


Note that the == operator 
cannot be used to compare 
strings of characters — it only 
compares ints and char in 
Digital C. This means that the 
\n must be enclosed in apos- 
trophes — if it were enclosed in 


Sinclair/QL World February 1991 


ge remomr; 


a 


ordinary quotation marks it 
would be a string! Inside 
apostrophes it means the Ascii 
code of the newline character. 

lfsome characters were typed 
into inp_name the next part of 
the program uses a for loop to 
replace any \n character in the 
string by a \0. As we have al- 
ready noted, fgets likes to puta 
\n at the end of the string that it 
gets. The for loop in the pro- 
gram processes each charac- 
ter in the array until it reaches 
the end of the string (marked 
by the \0 character). Any \n that 
is found within the string is re- 
placed by a \0. This effectively 
gets rids of the \n and marks a 
new end to the string. For ex- 
ample: 


f1p1_fred\n\o 


becomes 


f1p1_fred\0\o 


So far as C is concerned, the 
new string simply contains the 
characters f1p1_ fred since the 
first \O marks the end of the 
string. 

Once this has been done an 
attempt is made to open the 
file. This is done using the fopen 
function. The basic syntax is: 


file_descriptor_name = fopen ( 
file_ name, 


open_mode ) ; 


The file descriptor must be 
declared appropriately at the 
beginning of the program. The 
file_nameandopen_modecan 
each be either the name of a 
character array or a string of 
characters enclosed in double 
quotes. (If you guessed that 


#tdefine 
#define 
#define 
#define 
#define 


FILE int 


Esc 27 


main () 


t 


int inp val, 


sub; 

while { 
{ 

fgets { 


Lf 


for *¢ 


if ¢ 


LINES _PER_PAGE 
CHARS PER LINE 


FILE *file d; 


inp_name, 
( strcemp(inp_ name, 
/* No inp name entered */ 
exit); 
gub = 0; 
inp_name[ sub] 
++sub) 
if ( inp name[sub} 


/* Replace newline 


#include flpl_stdio h 
MAX_FILE_NAME 


50 


16 
73 


num_lines, 
num_chara, 


char inp_name[MAX FILE NAME}; 
file _d = NULL; 
file d == NULL ) 


fprintf(stdout,"Enter filename ( (ENTER) 
MAX FILE NAME, 
baa 0 Waa 


inp_name([sub] 


file _d = fopen ( inp name, 
/* Open the file for reading */ 


file _d == NULL ) 
fprintf(setdout,"\n\nUnable 
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they should be pointers to 
strings — you guessed right). 

The open_mode can be one 
of the following: 


r- opens the file to read data 
from it 

w - opens the file to write data 
to it, if the file already exists 
then its contents are deleted 

a- opens the file to add data 
to the end of it, ifthe file doesn't 
already exist then a new 
empty file is created 


The mode could be the name 
of an array containing the char- 
acters r\0 or w\0 etc or it could 
be “r’ or “w" etc (enclosed in 
quotes). 

If the fopen statement fails 
then the file_descriptor is set to 
NULL. If fopen succeeds it sets 
the file_descriptor to a non- 
NULL value. 


The fopen function will fail, 
for example, if you specify an 
invalid device name at the be- 
ginning of the file name (eg 
md1_ instead of mdv1_) or if 
there is no disk in the drive or if 
you try to open afile for reading 
and the file doesn't exist. 

Our program opens the file 
for reading. If fopen fails and 
the file_descriptor is set to 
NULL then a message is dis- 
played. At the end of the while 
loop, the descriptor file_dis still 
NULL so it goes round the loop 
again. 

Once the file has been suc- 
cessfully opened and file_d is 
not NULL the while loop termi- 
nates. 

The file’s contents are then 
processed within a for loop. 
The variables num_lines and 
num_chars are set to zero — 
since nothing has been dis- 
played yet. The loopis repeated 


stdin ); 


by end of string marker */° 


mye yy 


inp name); 
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=D 
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so long as the following ex- 
pression is true: 


{inp_val =getc (file_d)) |= EOF; 


The getc function is used to 
read a character from the file 
associated with the descriptor 
file_d — this is the file that has 
just been opened. The getc 
function is rather like getchar 
except you must use a file 
descriptor to tell it where to 
read data from. The value that 
is retrieved is stored inside the 
variable named inp_val. If you 
check the program listing you 
should find that inp_val is de- 
clared as an int — not asa 
char. This is not a mistake — it 


{ 


} 


else 


{ 


} 


putc(inp val, 
if ¢( inp_val == ‘\n‘) 


num lines == 


is absolutely vital! 

The for loop carries on re- 
peating so long as inp_val is 
not EOF. What is EOF? Per- 
haps you've worked out that it 
must be a symbolic constant 
thatis defined for youin stdio_h. 
It is! In Digital C EOF is given 
the value -1. (Some other imple- 
mentations of C use different val- 
ues, but this doesn’t matter.) 

When you use getc to read 
data from a file and there is no 
data left (because you have 
reached the end of the file) 
Digital C arranges it so that a 
value equal to EOF is passed 
back to your program. The 
value of EOF has to be differ- 
ent from all possible real char- 


pute(‘\n’,stdout); 
for ( num_lines = Q, 
(inp_val 


num_ chars 


= getc(file d}) != 


stdout); 


++num_ lines; 
num_chara = 0; 


++num_ chara; 


++num_lines; 
num chars = 0; 


fprintf(setdout,"\nPress a key to 
1£ ( fgetc(etdin) 


exit(); 


num_lines = Q; 
0; 


num chars = 


i 
} 


felose (file ad); 
fprintf(stdout,"\nPress a key to quit"); 
inp val = getchar(); 
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acter values — so it has to be 
outside the range 0 through 
255. If EOF was the same asa 
valid Ascii character code it 
would be very difficult to work 
out if you'd reached the end of 
the file or just a funny character 
part way through the file. This 
is why inp_valmustbe declared 
as an integer. If it was defined 
as a char you would get prob- 
lems. Char variables can only 
hold values in the range 0 
through 255 — they cannothold 
-1 (EOF). This means that if 
EOF was passed back to a 
char variable it would end up 
being converted to a value 
somewhere in the range 0 to 
255. Because of this it would 


always not equal EOF — and 
the for loop would never end. 

Itis easy for anewcomer to C 
to declare characters that are 
being read from files as char 
instead of int, but if you do then 
you can expect problems! You 
won't be able to spot when the 
end of the file is reached. 

Inside the for loop the putc 
function is used to copy the 
character that was read from 
the file to the stdout device. 
The rest of the for loop is con- 
cerned with stopping the dis- 
play after a screen full of data 
has been displayed - rather 
than letting it all scroll off the 
top of the screen. The basic 
logic used is as follows: 


QO; 
EOF; 


if ( num_chare == CHARS PER_LINE ) 


LINES PER_PAGE ) 


== ESC } 


continue —- ESC to 


| 


quit\n"); 
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1. Ifthe characteris anewline 
(\n) add 1 tonum_lines and set 
num_chars to zero - since no 
characters have been dis- 
played on the new line. 

2. If num_chars equals 
CHARS_PER_LINE the line is 
fullso add 1 to num_lines and 
set num_chars to zero. 

3. If num_lines equals 
LINES_PER_PAGE then the 
screen is full. Output a suitable 
message and wait for a key to 
be pressed. If ESC is pressed 
then exit the program, other- 
wise set num_lines and 
num_chars to zero and carry 
on around the loop to display 
another screenful. 

At the end of the loop the file 
is closed using fclose. The syn- 
| tax is: 


fclose { file_descriptor } ; 
Once the file has been closed 


the file descriptor could be used 
to open another file. 


Exercise three 


1. What would happen if the 
\n was not removed from the 
file name that was input using 


fgets? Try it out. 

2. What happens if you miss 
out the quotes from the 'r” in 
the fopen function? 

3. What happens if you try to get 
characters from a file that has not 
been successfully opened? 

4. the fclose function actually 
returns an integer value. A 
value of zero means that the 
file was successfully closed, -1 
means that it wasn’t. Amend 
the coding so that it checks that 
the file was closed properly. 
One way of checking that this 
works is to write a program that 
tries to close a file that has not 
been opened. Picking up the 
value returned by fclose in- 
volves using: 


integer_variable = fclose ( 
file_descriptor ); 


5. In listing three the final for 
loop reads characters and dis- 
plays characters. Try to re-write 
the whole thing so that it reads 
lines and displays lines using 
fgets to read them and fprintf to 
write them out again. You will 
need to define a character ar- 
ray in which to read the lines - 
and fix it so that the call to fgets 
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never reads more than, say, 73 
characters (a screen line full). 
You need to know that the fgets 
function returns a value of NULL 
if the end of file was reached. 


integer_variable = fgets (....) ; 
if (integer_variable == NULL } 


. {7 END OF FILE REACHED */ 


} 3 


6. Change the program so 
that it counts the number of 
words and lines in the input file. 

7. Write a program that does 
the following: 

a) Gets an input file name 
from stdin and opens the file for 
reading. 

b) Gets an output file name 
from stdin and opens the file for 
writing. 

c) Copies the whole of the 
input file into the output file. 

Be careful when you test this 
program - remember that if the 
output file already exists its 
contents will be deleted. It is 
probably best to play with a 
blank disk or microdrive car- 
tridge. 

Change the program so that 
it appends the contents of the 
input file to the output file. 


C is a much more versatile 
language than we have so far 
seen. Some of this extra versa- 
tility will be covered in future 
articles. 

For example it is possible to 
get a C program to read stdin 
data from a file instead of from 
the keyboard - and to write 
stdout data to a file rather than 
to the screen. All of this can be 
done without having to re-write 
the program atall. This process 
is sometimes called redirection 
(reading stdout from some- 
where different from usual and 
writing stdout to somewhere 
different). One of the few areas 
in which the MS-DOS operat- 
ing system is more convenient 
than Qdos is in the way it al- 
lows the redirection of stdin and 
stdout. In a future article we'll 
look at how this can be achieved 
using Digital C. 

It is also possible to take the 
stdout output from one program 
and pass it into the stdin of 
another program. This process 
is sometimes known as piping 
(the output of the first program 
is piped into the input of the 
second). Again, we'll take a 
look at this in more detail later. 


The Advanced Wordprocessor for the Sinclair QL 


Printer Drivers 


text®’ 


text®’ version 3.00 anatext budget ,offertoday's 
state-of-the-art user-friendly environment for document 
production. Extremely fast in operation with documents of any 
size and capable of mixing and displaying different type styles and 
sizes both on the screen and on paper. Supprts multiple columns, 
multiple rulers, and multi-line headers and footers. With integrated 
spelling-checker in three languages, editable dictionaries and 
extensive support for highest quality printing possible on 
daisywheel and 9-pin printers. Budget version cannot be used 
with 24-pin, laser and deskjet printer drivers. Upgrade to the full 
version will be availabe at the price difference. 


text87: £60 @ text87budget: £45 @ fountext88 + founted89: £40 
2488; £15 @ typeset90-deskjet: £20 @ 
typeset90-laserjet: £40 @ typeset90-GQ5000: £40 
Send for our new comprehensive leaflet 


Software available in English, French, German and Italian. Prices are 
inclusive of airmail. Payable by cheque, Postal Order or Eurocheque. 
Please specify language and disk system (all 31/2” and 51/4" formats 
can be supplied). text87 requires at least 256K memory expansion. 


text®” comes with about 30 sophisticated printer drivers for dot- 
matrix and daisy wheel printers supporting all the international characters 
available on individual printers and proportional spacing, double-width, 
condensed, itatics etc. if available. In addition, you can add any of the 
following drivers for state-of-the-art output not available from any other 
QL program. 


fountext®® ana founted®?, the graphic printer-driver and 
editor fortext87 provide high quality graphic founts without the limitations 
in text editing and document size imposed by QL desktop-publishing 
programs. More than 40 quality founts of up to 72 pixels in height are 
supplied and new founts can be designed or captured from saved screen 
images. For Epson and compatible 9-pin and 24-pin printers. 


24°83. text-mode printer drivers for selected Epson LQ, NEC P, Star LC 
and XB and Panasonic KXP 24-pin printers offer advanced features such 
as multiple typefaces, proportional spacing, micro-justification, double 
height, shadow and outline modes (depending on the printer model). 


typeset” is a set of three separate text-mode printet-driver products: 
typeset90-deskjet for Hewlett-Packard Deskjet, Deskjet Plus and Deskjet 
500 support printer's internal founts plus the full range of Roman, 
Helvetica and other plug-in cartridges. typeset90-laserjet and typeset90- 
GQ5000 are for Hewlett Packard laserjet and Epson GQ-5000 printers 
supporting a very large selection of founts in different sizes. 


Software87, 33 Savernake Road, London NW3 2JU 
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AN FTWARE FILE 


FILE EXECUTIVE 


Bryan Davies tries a thoughtfully- 
constructed new file-handling 
utility with a reasonable price-tag. 


INFORMATION: 
Program: File Executive 
V1.00 

Price: £12 

Supplier: J. O'Connor 

16 Parsons Way 
Wooton Bassett 
Wiltshire SN4 8DA 


15... LigoutGe LF A 
&, Liaise. flee 
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The instructions are quite 
comprehensive, and the avail- 
able functions are what one 
would now expect, after hav- 
ing had the use of Toolkits for 
several years; some of the 
functions are a bit unusual, 
though. The command format 
is much similar to that used in 


see sectors 
' STATDPEY ae 


STATrene 0 oye 


Sap Ey Ere 


13° LINPREF_LEPE 


Lins iE, 


a LINSA, . 
: LIS Pi 


SRINTER TAT 
STAT ouru exe 
fob bye 


puis 


ile Executive is 

a file-handling  util- 

ity, and comes on 

5'/ain or 3'/2in disk 
only, Instructions for use (11 
pages) are supplied in both a 
Quill and an Editor document 
on the disk with the program. 
The program file is compiled 
Super Basic and requires a 
Turbo Toolkit extensions file to 
be loaded before it. A run-time 
set of extensions is loaded au- 
tomatically by the boot, unless 
you choose to by-pass it be- 
cause you already have an 
equivalent file loaded. The 
provided commands work 
with microdrives or floppy 
drives, but not with hard disk. 
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The Editor — mainly mne- 
monic, single-letter, with 
parameters where appropri- 
ate. The interface with the user 
is through three windows, the 
main one to display requested 
information, and smaller, sin- 
gle-line ones above and below 
it to give basic information on 
the medium in use and to al- 
low the input of commands to 
give error messages. 

The program file is about 
36KB in size, and takes a total 
of around 50KB when in use. 
This size limits it to being the 
only job on a basic 128KB QL, 
but it shouldn't restrict nor- 
mal operations on a system 
with plenty of expansion 


v1 EP ot 


memory. 

The similarity of style to The 
Editor extends to the start-up 
and Help screens. Help is 
clearly laid out, and sufficiently 
descriptive without occupying 
toomuchscreen space. Youcan 
manage without the written 
instructions. The help file is not 
loaded into memory, so the 
program disk needs to bein the 
appropriate drive for help to 
be available. 

The commands available in- 


272 Get 
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clude the usual Directory, 
Copy, Delete and Format, but 
not Rename. In addition, you 
can View the contents of files, 
Find and Exchange strings 
within files, Get information 
ona file, Set the Dataspace allo- 
cated to a program file, View 
the Status of a medium, and 
Print the Current Directory. 
Command files (as in Editor) 
can be used, commands can be 
chained one-after-the-other, 
and they can be repeated. 

The single-letter commands 
are easy to remember, being in 
mnemonic form. For example, 
the format of the command for 
displaying a directory on the 
screen is: 


r [device] {[specifier]] 


where “r” indicates read, “[de- 
vice]” is the device name in the 
usual form — flp] or flp1_ will 
do — and “{[specifier]}” is for 
a string within a file or files. If 
a specifier is present, the direc- 
tory displayed will be of only 
those files which contain the 
string. The instructions are a 
bit misleading here, in that the 
specifier string has to be a part 
of the file name, rather than 
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being part of the file itself as 
implied by the description of 
the function. It is a pity the 
square brackets are used in the 
opposite sense to that many 
users will be familiar with; that 
is, the presence of [] indicates a 
mandatory parameter, rather 
than the more-usual optional 
one. The curly brackets are 
used to enclose optional items; 
using square brackets within 
curly ones seems unnecessary. 
Several commands can be en- 
tered in sequence, separated 
by semi-colons. For example: 


r/flp2;bz 


will cause a directory of all 
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files on flp2 to be displayed, 
followed by a buzz from the 
QL’s magnificent speaker. 
Commands — including sev- 
eral on one line can be 
repeated by preceding them 
with the figure for the number 
of repeats, asin <10(bz;r/flp1)> 
to make the speaker buzz ten 
times, with the directory of 
flp2 being displayed after each 
buzz. An indefinite repeat is 
obtained by using <rp>— <rp 
bz> will keep the speaker 
buzzing continuously. All this 
will be familiar to the users of 
The Editor. 

The QL function keys areused 
for familiar operations; Fl 
brings up help information, F2 
recalls the last command used, 
F4 rewrites the screen, and F5 
enables the program main 
window size to be altered and 
the position to be changed, 
using the cursor keys, alone 
and with ALT. Commands can 
be aborted during execution 
by pressing ESC. 

Parameters can extend the 
utility of commands consider- 
ably, and a decent selection is 
offered. Numbers, text or 


Found, Press Hray Key 


You can specify a range of files 
(by number) to be copied; when 
only one file is specified, you 
can also give the file copy a 
different name from the origi- 
nal. The same format is used 
with the Delete command, Files 
can be viewed; they normally 
pass through the window ina 
continuous stream, but the up- 
cursor key pauses the flow, and 
ESC stops the operation. Find- 
ing and Exchanging Strings 
within files is a similar opera- 
tion to Viewing files, but the 
specified string will be dis- 
played in inverse video 
whenever it is encountered, 
and the number of occurrences 
of the string will be displayed 
when the operation has been 
completed. The format for a 
find and exchange is: 


es [filenumber] [devicel 
[source] [dest] 


where “[source]” and “[dest]” 
are the string to be found and 
the one to replace it by, respec- 
tively. 

The Getting and Setting In- 
formation function reads the 


1154/1446 


iS runtine cde sat 


strings can be used, strings 
having to be enclosed in quota- 
tion marks. Quotation marks 
are also needed when charac- 
ters are used which the 
program would otherwise rec- 
ognize as “for other purposes”; 
for example, a name which in- 
cludes spaces must be enclosed 
by quotes. Files can be identi- 
fied by Ranges, such as 1,3,5 or 
10-20, or a mixture of the two 
forms. Parameters can be sepa- 
rated by full stops, spaces, 
commas or slashes. 

The Copy command includes 
the Wild Card option, and the 
standard Y/N/A/Q(yes/no/ 
all/quit) query, including 
when overwriting is necessary. 


file header and displays the file 
name, length, date of creation, 
type (job or data), and 
dataspace (if the file is a job). 
Combined with this command 
is one to permit the user to 
alter the allocated dataspace 
fora job. The Format command 
is basic,and accepts no param- 
eters other than the device 
name; you are asked to con- 
firm that you wish to proceed 
with the format. 

It is a pity no provision was 
made for giving the medium a 
Volume Label, nor for format- 
ting to anything other than a 
default number of sectors. 
Viewing the Status of a me- 
dium produces a display of 
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the medium label, write status 
(protected or not), total and 
available storage space in sec- 
tors and kilobytes, number of 
files present, number of files 
selected (by a previous com- 
mand),search string (specified 
with the Read / Directory com- 
mand). 

Command files can be writ- 
ten with any WP or editor 
program, provided you can 
ensure the resulting file does 
not contain unwanted control 
codes. Quill is suggested as 
being usable for this purpose; 
presumably you would have 
to Print the file to disk/car- 
tridge with no printer-driver 
present. The supplied demon- 
strationcommand fileisshown 
in the illustration, which also 
shows the alternative display 
fount and another window po- 
sition. As can be seen, several 
lines of commands are possi- 
ble. Comments can be inserted 
into a command file by prefac- 
ing the line with an asterisk. 
You can also display a prompt 
such as “Insert disk into flp1” 
in the command window, and 
cause the command file to be 


played, with truncated file 
names being terminated with 
afullstop toshow that they are 
incomplete. The display col- 
ours can be altered within the 
basic QLrange of 256 “colours”; 
this is, perhaps, only a frill, but 
continuous use of a utility can 
lead to irritation with certain 
colours or combinations. 
Somewhat unexpected in a 
cheap utility is the facility to 
change the case of file names, 
the options being lower-, 
mixed- or upper case. The Sort 
facility allows files to be sorted 
into alphabetical order whena 
directory is read. Subsequent 
copying will be done in the 
displayed order, not the actual 
one on the medium. 

A routine CONFIG_TASK is 
provided, to enable the user to 
specify the name of the defaults 
file, which is read when the 
program starts running, and 
the location of the help file. 
Error messages from the pro- 
gram, and from QDOS, are 
displayed in the small, lower 
window. The instructions ex- 
plain the program messages (11 
of them) and you are referred 
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paused until the key is pressed. 

There is a Zap command, 
which¢learsinformation onthe 
current medium from memory 
(without doing anything to the 
medium!) The currently -dis- 
played directory can be sent to 
a printer (the port can be speci- 
fied) and printed in the same 
format as it is displayed, using 
an 80-character width. The 
buzzer command (bz) could be 
handy if the user wants warn- 
ing of when a long command 
sequence has been completed. 
The number of columns in the 
window display defaults to 
three, which is probably the 
best choice for most users, but 
the illustration shows four dis- 
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to The QL User Guide, Con- 
cepts section, for explanation 
of QDOS messages. The pro- 
gram did not “fall over” when 
errors occurred during the re- 
view. 

File Executive worked along- 
sideseveral other EXEC-ed jobs 
on the review system without 
apparent interaction. [tis nota 
pop-up job, as the comparable 
program Files (from Sector 
Software) is, but you can use 
CTRL-C toreturn toit from the 
current application, rewriting 
the display using F4 if neces- 
sary. The displaying of a basic 
directory is done quickly, the 
default display being three 
columns wide by 13 rows deep 
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] columns, ink 
and paper col- 
ours, Copy 
speed (in terms 
of the basic OL 
methods of 
copying and the 
use or otherwise 
of the Overwrite 
query), sort fa- 
cility on/ off,and 
the device name 
for the default 
fount file. 

One = opera- 
tional problem 
was noted. 
When the pro- 
gram was quit, 
inthe prescribed 

fashion (using 
| the <qu> com- 


— that is 39 files at a time. Re- 
sizing the window to the 
maximum screen size increases 
the potential number of files 
displayed to 96. No doubt 
many users will be irritated by 
the way the QL’s built in DIR 
command, and the add-on 
commands of other utilities, 
restrict the number of files dis- 
played simultaneously, and 
File Executive does a better job 
here. Some long file names will 


get truncated when the default 
window size is used, and if 
you use the option to increase 
the number ofd isplay columns 
above the default of three, but 
the user has the freedom to set 
whatever number of columns 
and the window size that best 
suit the file names used. A de- 
faults file allows the user to 
save these settings — screen X 
and Y co-ordinates and dimen- 
sions, number of displayed 


mand), in order 
to restart it with the default 
settings, it refused to load; ini- 
tially, the message from QDOS 
was “out of memory” (the free 
space reading was 175Kb) 
when the command <EXFILE 
EXECT. ASK> was used, 
changing to the old-familiar 
Turbo one of “Task...halted, 
after line 0...” when the com- 
mand was expanded to 
<EXECFLPI1 FILE 
EXECT ASK>. Yes, I know I 


should remember the answer 
to that one! The average user 
will not be aware of what to do 
next, though. 

Maybe, some day, someone 
will properly sort out the prob- 
lems associated with 
extensions which are 
“present”, but not “correct”. 
Another minor problem was 
that the demonstration file 
moved the window and 
changed the screen fount, and 
you would have to use both 
the Fount and F5 commands to 
get back to the settings (assum- 
ing you remembered the 
position and size figures). 

All-in-all, the program is a 
workmanlike job, operates 
smoothly and speedily, and has 
little to its debit. Thoughtful 
touches, like ensuring that the 
results of a command are dis- 
played immediately, without 
the user needing to take fur- 
theraction, show that the writer 
has given serious thought to 
the project. The price is reason- 
able; no doubt there are still 
some users who do not have 
any of the well-known utility 
programs, and they should 
give this one serious consid- 
eration when deciding to make 
a purchase. 


}QLSUPERTOOLKITIbyTonyTebby SUPERTOOL KIT II by Tony Tebby 


TONY TEBBY SOFTWARE (QJUMP) 


LD LT LD LD Le a i a 


Default Directories, Extended 
16k Eprom Cartridge Version . 


j= 


‘3 
j= 


QL HARDWARE 


Dual 3. 
3.5" DS’‘DD Discs - 


QL Keyboard Membrane . 


Care Eprom Cartridges each .. 
ULA CHip 2X6301 


STAR LC 10 Mono .. 
STAR LC 10 Colour .. 
CITIZEN SWIFT 24-pin Colour 


FOUNTED 89 , 
FOUNTEXT 88 
TEXT 87/FOUN 
248B PRINTER DRIVER ..... 


MONITORS (Pr cluding lead) READYMADE LEADS GARSTON, WATFORD, 
Philips BM7522 Amber Hi-Res ... ve @E97.754 AGB OL to PHONO cecosesscses . @E5.75c HERTS, WD2 6NL. 
Philips CM6833 Colour Med-Res @£253.00a AGB 8-6 pin DIN @€7.13¢ Tel: 0923-672102 
Chips AY iaoo Tv dlunet (orabove “@£69-00b GB 8-7 pin DIN (Hitachi) @£7.13¢ ia 

ilips 7502 Green Hi-Res ....... -£97.76a RGB 8-7 pin DIN (Ferguson) ” @ET13c Fax: 0923-662304 

RGB 8 pin to SCART (Euro) -@£11.50c ; 
]HOWTOORDER: | TO ORDER: ALL PRICES INCLUDE VAT 6-way PCC 25-way ‘D’ (Printer-Ser 1) vse... @£9.89c Please add carriage 
a=£11.50 b=£3.45 
By Post. Enclose your Cheque’PO made payable to CARE Electronics or use ACCESS :VISA. Allow 7 days for delivery c=£1,38 d=2,30 


Over 118 Commands:- Full Screen Editor, wey. Define Print 
Using, Last Line Recall, Altkey, Job Control, Fil 


letwork, 


Configurable Version on Microdrive . 


MIRACLE SYSTEMS PRODUCTS 


DK Disc Interface (Inc Tool Kit I) .. 
QL Centronics Printer Interface - 
QL Expanderam 512K Thrucard ..., 


Single 3.5" Dise Drive & (Own PSU) . 
Disc Drive & (Own PSU} 

10 off... . 
Q POWER REG. The only real solution to you QL overheating 
(switched mode power supply run cold) 


QEP |Il Advanced Eprom Programmer 


PRINTERS 


SOFTWARE 87 (State MDV or Disc) 


TEXTS87V.300 (Requires Min 256k) 


Upgrade to Text 87 V.c 00, Re urn old copy together with 


ilé Handling, QMON II 


@£24.15d 
-@£24.15d 


@£99.82b 
-@228.75d 
@£99.99e 


@£103.50a 
@£188.60a 
-. @E9.20c 
... £24.15¢ insertion ......... 
@E£11,50d 
@£121.90d 


@f179.40a 
- @£224.25a 
.-. @2£356.50a 


-@£25.00c 
@94,99b 
-@£15.00¢ 


.@£25.00d 


QLFP (Micro/P disk interface aaa 


QTYP Type/Spell Checker .. 


typewriter, digital clock sysmon . 


ZITASOFT SOFTWARE by Steve Jones 


LOCKSMITHE copies M/DRIVE - M/DRIVE .. 


“The: above | programs ¢ are 2 not for u use in nthe UK 
SIDEWINDER - High resolution printer driver prints full 
screens or parts of screens from postage stamp size to 
large banners. Prints sideways, invert, scale, mirror, text 


Upgrade to Sidewinder PIUS «os...» 


HEAT TRANSFER RIBBONS & PENS 


Print your own T-shirt Design, Just print on paper and iron 
onto your T-shirt. 

@£60.00d Star LC10NX1000, Rainbow .. 
-@E15,00C Star LC10NX1000, Black .. 


.. @£14.95d 
@£23.00d 


-@£19.95¢ 


SIDEWINDER PLUS - (for ‘expanded foe s) ‘includes all the 
features of above, PLUS multiple label printing, desktep 
publishing files and printer driver for 24" pin plus LC10 and 
Jx80 colour printers, (Please state 3.5" disc or M’D} 


-@£23.00c 
. @EB.05c 


vw. @E17.25c 
- @£11,50c 


Epson FX80, MX&80, LX80, Fx100/Okidata ML80 Citizen 
120D/Star NX10, Black, Panasonic 1080/81 ... 
Small 5 colour pen set ..... 
Jumbo 5 Colour Pen Set .. 


@£11.50c 
«> @E12.68c 
.-. @£16.10c 


AS REVIEWED QL WORLD 


800 ST ALBANS ROAD, 


4MATTER + LOCKSMITHE copies M/DRIVE - DISC vevss-s-eetttceeereseeeecteeeeceeeis -+-1= DEAG.S1B 
..@£23.00¢ Upgrade QRAM to QPAC Il return master 
eceesnavhemrosinsnesteonteteinnage versie weve @L29,906 


... @£29.09d OPAC II Main menu windows adjust automati- 
QPAC 1-Desk top accessories, ‘calander, alarm, calculator, cally to size. Files, directory, view, print, delete, 
...@£21.85d backup, jobs, pick, Rjob, sort, channels, things 
exec, wake, buttons, Hotkey, Hotjobs. Fully 
multitasking, allows many programs to run at 
..@£14.95¢ once. Requires min of 256k expanded memory 


CARs 


OPEN 
Sam-5pm Mon-Thu 
Sam-4pm Fri 


4 4) 49 49 49 4 £7 
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he transfer of text between the 

QL and a PC is a recurring need 

for many users, and there are 

even commercial programs to 
assist inthis. Thesuggestion detailed here 
is a DIY system, to transfer text without 
having to leave your QL program such as 
Quill. This simplifies the process, and re- 
moves the need for temporary _lis files. 
As far as the program is concerned, it is 
printing the document. However, instead 
of the lead being plugged in to the printer, 
it will be attached to the serial socket of a 
PG, 

There are three elements required: 1. A 
suitable lead. 2. A suitable printer driver. 
3. MS-DOS commands to get the PC to 
receive the incoming data. 


File Transfer: 
QL TO PC 


& Robin Stevenson joins the dots. 


joined together. The simplest way to do 
this is to solder short sections of wire to 
each of these pins, and then solder the 
other ends together in one big, ungainly 
lump. Do this ona short extension to your 
printer lead, so that you can still use the 
original for your printer. The extension 
can also reverse the gender of the lead. A 
PC will require a female end to the lead, 
whereas most printers expect a male one. 
Figure One shows how you would make 
up a single, dedicated lead. Figure Two 
shows our hypothetical printer lead, plus 
the extension needed to make it suitable. 

The Psion printer driver incorporates 
features which make it very useful for 
transfers. In particular the ability to specify 
any characters for bold, underline etc. 


separate cartridge from Quill, you need 
only insert itinto MDVL_ when you wish 
to transfer. The rest of the time, your 
normal printer driver will be used. 

Finally there are the PC commands. To 
set up the PC’s serial port, you need to 
enter 


MODE COM1:1200,n,8,2 


which is an MS-DOS external command. 
It configures serial port 1 with appropri- 
ate baud rate, parity, data bits and stop 
bits. Then, for every file you wish to trans- 
fer, before sending the print instruction, 
you need to enter 


COPY COM] FILENAME.TXT 


where filename.txt is your own choice of 
name, including any appropriate path, 
and extension. A useful variant on this, 
while testing is 


PY COM] CON 


which will send it to the PC’s screen in- 
stead of to disk. 


Figure One Figure Two - Extension to QL serial printer lead. Figure Three 
Dedicated Qi -to-PC Lead. Psion printer driver, for 
QL serl Printer Extension PC Coml WordStar transfer format. 
QL PC plug serial plug Plug Plug 
Ser] plug faml plug NAME © QLtoPe 
1 1 PORT : ser) 
: : ; BAUD RATE : 1200 
5 tas > . PARITY : none 
_ a : : CONT. FORMS ; yes 
5 : END OF LIN€& ; CR,LF 
6 : PREAMBLE =: none 
7 a 8 4 POSTAMBLE Su 
8 2 ° 5 BOLO ON + STX 
hut BOLD OFF =: SIX 
if UNDER ON > DCS 
pa UNDER OFF oc3 
a SUBS. ON + SYN 
SUBS. OFF SYN 
SUPER. ON 
SUPER. OFF 
Female Male Female Female TRAN ] '£,27,156,28 


To start with the lead, getting the right 
connections is a manageable DIY job, pro- 
vided you have access to a lead for the QL 
serial socket. Many users already have a 
serl-to-25 pin serial printer lead. If so, the 
necessary adaptor can be made as a short 
extension to that. The only wires that 
need to go all the way through are the 
signal ground (pin 1 on the QL; pin 7 on 
the PC or printer plug), and the data lines, 
(pins 2 and 3 in both plugs). The data lines 
need to cross over, so that the QL’s pin 2 
goes to the PC’s pin 3, and vice versa. In 
most printer leads, this cross-over will 
already be present, so the extension just 
carries the three wires directly across to 
their matching pins. 

In addition, you need to convince the 
PC that something is about to happen. To 
do this, pins 5, 6, 8 and 20 all need to be 
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makes it possible to convert your embel- 
lishments to WordStar format, during the 
transfer. Any word-processor which al- 
lows importing of WordStar format text 
(suchas LocoScript PC) willbe able tomake 
sense of these. It may be best to have no 
left hand, top or bottom margins, and no 
headers or footers. These can then be set 
by the receiving program. 

Figure three shows a suggested printer 
driver, to produce WordStar compatible 
text. If you don’t use the print enhance- 
ments any other word-processor should 
be able to use the result, if it can use or 
import standard Ascii files. The really 
vital settings are the baud rate, which 
must match the PC, and the Postamble, 
which must send the Control-Z value 
(Ascii 26, or SUB), to denote the end of the 
file. If you put this printer driver on a 


Exactly the same technique should be 
usable from any other program. The same 
printer driver can be used tosend Archive 
and Abacus reports, and provided you 
can set the baud rate, and send the Con- 
trol-Z end-of-file marker, any other 
program that can print out could use the 
same technique. — 

If you need to transfer QL files directly, 
rather than by printing them, you can do 
this by using the SuperBASIC command 


BAUD 1200 
After entering the MS-DOS COPY com- 
mand, you can initiate the transfer from 


the OL with the line 


COPY_N MDV2_FILENAME_EXT TO 
SERIZ 
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